Projects

Projects are the top-level container in auralogs. Each project has its own log stream, analysis history, ingest keys, and read keys.

Creating a project

1. Sign in at auralog.ai.
2. Click New Project on the projects page.
3. Name your project (e.g., “my-api”, “frontend-app”).
4. Choose whether to add an AI provider key now. You can start without one; logs still ingest, and you can use the dashboard, REST API, and MCP server. Add an Anthropic or OpenAI key later if you want auralogs-generated analyses.
5. After the project opens, copy the one-time startup keys:
   • Ingest key — starts with aura_; use it in your SDK init() call to send logs.
   • MCP/API read key — starts with aura_read_; use it with MCP clients or the REST API to read logs.

Plaintext keys are shown once. If you supplied a provider key during creation, it pre-populates Settings → AI providers and pre-selects matching models under Model routing — you can change either later.

If you closed the startup modal without copying a key, create a new one under Settings → API & MCP keys. You can revoke the unrecovered key from there too.

API & MCP keys

Each project can have multiple keys:

• Ingest keys send logs from your app to auralogs.
• Read keys give MCP and REST clients read-only access to one project. Use them when you want Codex, Claude, Cursor, another MCP client, or a REST script to inspect logs without write access.

Create additional keys, revoke old keys, or rotate keys from Settings → API & MCP keys. Revocation is immediate.

Connecting a GitHub repo

GitHub is optional. Connect a repo only when you want auralogs to map analyses back to source code and open autofix PRs:

1. Go to your project’s Settings.
2. Under Repository, click Connect Repository.
3. Authorize the auralog-autofix GitHub App for the repo you want, then pick it from the list.

Each project can connect to one GitHub repo. Each repo can only be connected to one project.