KodaCode
Coming soon
Docs/Reference

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.tomlEvery setting. See below.
AGENTS.mdInstructions for the agent in every project.
agents/*.mdYour global agents.
skills/<name>/SKILL.mdYour 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/*.jsonYour personal automations.
hooks.jsonHooks that run in every project.
themes/*.jsonVS Code colour themes. See Themes.
transcript.dbYour sessions.
logs.dbKodaCode's logs.
images/Images from sessions.

A project's .koda folder

PathWritten by
agents/*.mdYouProject agents, shared with the repo.
skills/<name>/SKILL.mdYouProject skills.
automations/*.jsonYouProject automations.
mcp.tomlYouProject MCP servers. Each must be approved.
hooks.jsonYouProject hooks. Each must be approved, and approved again after a change.
review-rules.mdYouRules for /review-rules and the Custom review part.
DockerfileYouThe project's container image.
graph.jsonYouWhat the code graph indexes. Optional.
memory/ or memory.jsonKodaCodeMemory.
plans/KodaCodeAccepted plans.
reviews/KodaCodeReview reports.
checkpoints/KodaCodeRewind snapshots.
worktrees/KodaCodeCopies that goals and crews work in.
crew/KodaCodeCrew 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.

TableKeys
top leveltheme, 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