Configuration
Codeep stores its configuration in ~/.config/codeep-nodejs/config.json. You can change settings via the /settings command or by editing the file directly.
API Keys
API keys are stored in the config file under providerApiKeys. You can also set them via environment variables — these take priority over stored keys.
| Provider | Environment Variable |
|---|---|
Anthropic | ANTHROPIC_API_KEY |
DeepSeek | DEEPSEEK_API_KEY |
Google AI | GOOGLE_API_KEY |
Z.AI | ZAI_API_KEY |
MiniMax | MINIMAX_API_KEY |
Agent Settings
| Setting | Default | Description |
|---|---|---|
agentMode | on | on = always use agent, manual = use /agent command |
agentConfirmation | dangerous | always / dangerous / never — when to ask for confirmation |
agentAutoCommit | false | Automatically commit after agent completes |
agentAutoVerify | off | build / typecheck / test / all — run after changes |
agentMaxIterations | 50 | Maximum agent loop iterations (modern models rarely need more) |
agentMaxDuration | 20 | Maximum agent duration in minutes |
agentMaxFixAttempts | 1 | Auto-retry attempts on incomplete work |
Session Settings
| Setting | Default | Description |
|---|---|---|
autoSave | true | Auto-save conversations to .codeep/sessions/ |
autoSessionTitle | true | Generate an LLM one-liner title per session on save. Makes a small background API call (uses the active model). Set false to avoid any unsolicited API calls. |
autoSummarizeHistory | true | When prior history overflows the agent's context budget, summarize the dropped (oldest) messages instead of truncating them. One cheap LLM call, only on overflow, cached per session. Set false to fall back to plain truncation. |
★
Two settings can trigger a background API call you didn't explicitly request:
autoSessionTitle (the readable titles in /sessions and /recall) and autoSummarizeHistory (condensing dropped history on long runs). Both default to on; set either to false in /settings if you prefer zero unsolicited calls.Per-project config
You can override settings per project by creating a .codeep/config.json file in your project root.
★
Create the
.codeep/ directory manually in your project root to enable per-project config. Codeep will detect it automatically on startup.Project Rules
Create a .codeep/rules.md or CODEEP.md file in your project root to define project-specific instructions. These are injected into every prompt automatically. See the Project Rules page for details.
# .codeep/rules.md
- Use TypeScript strict mode
- Always write tests for new functions
- Prefer functional components in React
- Use Tailwind for styling, no inline styles