Files & folders
What KodaCode reads and writes, in your data folder and in each project's .koda folder.
Your data folder
~/.config/kc, or the folder in KODA_DATA_DIR.
| Path | |
|---|---|
config.toml | Every setting. See below. |
AGENTS.md | Instructions for the agent in every project. |
agents/*.md | Your global agents. |
skills/<name>/SKILL.md | Your skills. KodaCode also reads ~/.agents/skills/. A skill installed from a link holds .koda-source, which records the link. A hidden skill holds .koda-hidden. |
automations/*.json | Your personal automations. |
hooks.json | Hooks that run in every project. |
themes/*.json | VS Code colour themes. See Themes. |
transcript.db | Your sessions. |
logs.db | KodaCode's logs. |
images/ | Images from sessions. |
A project's .koda folder
| Path | Written by | |
|---|---|---|
agents/*.md | You | Project agents, shared with the repo. |
skills/<name>/SKILL.md | You | Project skills. |
automations/*.json | You | Project automations. |
mcp.toml | You | Project MCP servers. Each must be approved. |
hooks.json | You | Project hooks. Each must be approved, and approved again after a change. |
review-rules.md | You | Rules for /review-rules and the Custom review part. |
Dockerfile | You | The project's container image. |
graph.json | You | What the code graph indexes. Optional. |
memory/ or memory.json | KodaCode | Memory. |
plans/ | KodaCode | Accepted plans. |
reviews/ | KodaCode | Review reports. |
checkpoints/ | KodaCode | Rewind snapshots. |
worktrees/ | KodaCode | Copies that goals and crews work in. |
crew/ | KodaCode | Crew job logs and results. A job's folder is removed when the job lands, or when you apply or discard it. |
At the project root KodaCode reads AGENTS.override.md or AGENTS.md, and CLAUDE.md (for the rules review).
Hooks
hooks.json uses the format Codex and Claude Code use. Events: PreToolUse, PermissionRequest, PostToolUse, PreCompact, PostCompact, SessionStart, SessionEnd, UserPromptSubmit, SubagentStart, SubagentStop, Stop and Interrupt. A hook gets the project folder in KODA_PROJECT_DIR. Manage them in Preferences → Hooks.
config.toml
Preferences → Open config file opens it. The app writes the settings that you change here. The Settings pages name each one.
| Table | Keys |
|---|---|
| top level | theme, density, tool_view, show_thinking, transcript_turns, ui_font_size, code_font, code_font_size, code_ligatures, star_animation, border_animation, editor_wrap, show_files, show_inspector, max_steps, limit_steps, context_ceiling_percent, prompt_cache, spill_retention_days, mask_secrets, mcp_approval, shell, extra_skills_dirs, hooks_trusted, hooks_disabled |
[sandbox] | kind, image, share_docker_host, apply_edits_host, apply_edits_container, outside_commands_host, outside_commands_container |
[background] | max_agents, goal_budget_usd, review_reminder, on_close, outside_project |
[reliability] | attempts, recovery_cycles |
[review] | parts_at_once, threshold, challenge_each, patch_base, scanners, refresh_daily |
[web] | search, max_results |
[memory] | enabled |
[crew] | dependency_folders, parallel_jobs |
[crew.supervised] | leader, worker, reasoning, stronger, review, budget, budget_dollars, budget_tokens, retries, skills, memory |
[crew.self_managed] | worker, reasoning, rounds, open_tasks, skills, memory |
[terminal] | floating, height and the floating position |
[[allowed_directory]] | Additional Directories |
[[mcp_server]] | See MCP servers |
[[project]] | name, path, sandbox, apply_edits, outside_commands, environment, memory_file, review_after_turn, provider, model, max_agents, disabled_hooks |