Overview

Projects are the top-level organizational unit in Contox. Each project has its own memory brain, sessions, and settings. A project typically corresponds to a single codebase or repository.

Creating a project

1. Navigate to the Projects page in the dashboard
2. Click New Project -- a modal appears with a creation form
3. Enter a name (e.g., "my-saas-app") and optional description
4. Choose the visibility setting (Public or Private)
5. Click Create

The project card appears immediately in the project list:

You can see the project name, description, context count, and status badge. Click the gear icon on the project card to access settings.

Project settings

Name and description

The project name is displayed throughout the dashboard and in the brain document. Choose a descriptive name that your team will recognize. The description is optional and appears in project listings.

Visibility

Projects have two visibility modes:

Public visibility is useful for shared repositories that the entire team works on. Private visibility is appropriate for personal projects or sensitive codebases.

AI Model

Configure the enrichment AI model per-project. Open project settings and go to the General tab:

• Small (mistral-small-latest) -- Fast and cost-effective processing
• Medium (mistral-medium-latest) -- Higher quality analysis and extraction

The default model depends on your plan (Small for Free/Personal, Medium for Team+). All paid plans can override the model. Free plan users see the options but must upgrade to change them. Setting the model to "Default" uses your plan's built-in model.

Repository

Link a GitHub repository to enable deep enrichment -- AI reads your source code for richer memory. Open the Repository tab in project settings.

Connecting with GitHub OAuth (recommended)

1. Click Connect with GitHub
2. Authorize Contox in the GitHub OAuth popup
3. Select a repository from the picker
4. Done -- deep enrichment is enabled by default

Connecting with a Personal Access Token

1. Toggle to Personal Token in the connection form
2. Enter the repository URL (e.g., https://github.com/org/repo)
3. Paste a GitHub PAT with repo scope
4. Click Test Connection to verify access
5. Click Save & Connect

Deep Enrichment toggle

Once connected, the Repository tab shows a Deep Enrichment switch. When enabled (the default), the pipeline adds a deep_enrich stage that reads source files from your repo and enriches memory items with implementation details (routes, schemas, function signatures, auth flows).

Disable the toggle to skip GitHub API calls and reduce token usage.

Managing the connection

• Change repository -- Select a different repo without re-authenticating
• Unlink repo -- Remove the repo URL but keep GitHub authentication
• Disconnect GitHub -- Remove all GitHub credentials and repo data

Status

Projects can be active or archived. Archived projects retain their data but do not accept new events or sessions.

Member management

Adding members

1. Open your project and go to Members
2. Click Add Member
3. Enter the email address of the user to invite
4. Select a role (admin or member)
5. Click Invite

The invited user receives an email notification. They must accept the invitation to gain access.

Roles

Project members inherit their team role, but project-level access is also controlled by visibility:

Removing members

Click the remove button next to a member's name to revoke their access. This takes effect immediately.

Project data

Each project contains:

• Brain -- The assembled memory document
• Sessions -- History of captured work sessions
• Memory items -- Structured knowledge extracted by enrichment
• Contexts -- Hierarchical context tree
• HMAC secret -- Used for V2 ingest authentication

Deleting a project

Deleting a project permanently removes all associated data including memory, sessions, contexts, and settings. This action cannot be undone.

1. Open the project settings
2. Scroll to the danger zone
3. Click Delete Project
4. Confirm the deletion

Next steps

• Memory -- View and manage project memory items
• Sessions -- Monitor sessions and trigger enrichment
• Team -- Manage team-level access