Skip to content

armgit / cogit

Public Imported from GitHub
0

Git for the intent behind agent-written code. Records what your coding agent decided and why, and links every commit to it.

6.5 KB
Raw Blame

Settings

Settings are global: one file for every project on this machine (~/.config/cogit/config.json). Change them under Settings in the map or the panel, or with cogit config set <key> <value>; cogit config get lists them all.

In the panel

Recording

recorder · default side

How much of the chat goes into the record.

Economical (recommended): a small model records in the background every few turns and closes each session with one pass that finds its threads, writes the branch summaries and one line on where the session left off. The agent is never interrupted; it costs under 2 cents per 20 messages. Detailed: on top of that, the main agent records its own decisions every 15 turns. It catches the agent's technical choices best and costs about 1–2% of a session. A third mode, where only the main agent records, is set with cogit config set recorder agent.

One-line summary under each message

messageSummaries · default true

A sentence under each message title on the map.

A one-sentence summary under each message title: what came of it. Without it, a message that only discussed or advised keeps nothing but its title. Off keeps the record shorter and cheaper. Branch summaries and the line on where a session left off are written either way.

Record at session start

startupContext · default true

Hand the agent the previous session's record when a chat starts.

When a chat starts, the agent gets a short summary of where the previous session left off and how to read the record. It costs a few tokens; turn it off if your projects are unrelated.

Headless sessions

recordHeadless · default false

Record sessions that start without a person, such as claude -p.

Some plugins and scripts run claude -p in the background, often once per prompt. Off, cogit leaves those sessions out of the map and the inbox. Turn it on if you do real work through claude -p or the SDK and want it recorded.

Tried-before notes

tryBeforeNotes · default true

Before the agent edits a file, tell it which options earlier thoughts rejected for it.

Before the agent edits a file, it hears which options earlier thoughts tried and rejected for that file. These are notes from the record, never rules; they can make the agent ask before repeating a dead end.

Intent, Shape and Code

shapes · default true

A small picture of what each change does, beside its reason and its diff.

For every message that landed commits, a small representation of what the change does: numbered plain-language steps or a Mermaid diagram. It sits between the record's intent (the decision, reason and rejected options) and the code (the diff), so a reviewer sees why, what and how in one place. The recorder writes it, not you; it costs one small model call per such message. Off, the map says so and nothing is written.

Tasks

captures · default true

A short list of what each session left undone, drafted by the side model.

When a session ends, the side model reads what its record left open and drafts at most three things a person would ask for, in the conversation's language. The list is yours: accept, dismiss or close each item. Sessions with nothing open cost no model call; the map's Tasks button appears only while something waits or is open. Off, nothing is drafted and the list already in the store is kept, not deleted.

Language

language · default auto

Language the agent writes records in; auto follows the chat.

The language the record is written in. With auto, it follows the language of the conversation.

Share conversations

shareConversations · default false

Send the raw chat text too, not only the session record (off: chat stays local).

In a project that shares its record, also send the raw chat text. Leave it off to keep conversations on your machine while teammates still see titles, decisions and reasons.

Only through cogit config

These are set up once, per project, or rarely touched, so the panel leaves them out.

Record every N turns

updateEveryTurns · default 15

Ask the agent to record after this many turns.

How often the main agent is asked to update the record inside the chat. In mixed mode the side model records in between, so this can be rare (15 turns by default).

Side model every N turns

sideEveryTurns · default 5

How often the background recorder writes in mixed or side mode.

How often the small side model records in the background. A lower number keeps the map fresher and costs a little more; a higher number is quieter.

Side model at session end

sessionEndCatchUp · default true

When a session ends, the side model records what is left and closes the session.

When a session ends, the side model records whatever nobody got to, then reads the whole session once to find its threads, write the branch summaries and one line on where it left off. It runs outside the chat, so it does not spend the session's tokens.

Side model

sideModel · default haiku

The small model that records outside the chat.

The small model behind every side record: every few turns in mixed mode, all the time in side mode, and at session end. Haiku is cheap and good enough for titles, parents and short decisions.

Agents

agents · default claude-code

Which agents record lineage; change it with cogit config set.

Which AI agents in this project should record what they are asked and what they decide. Claude Code is the only one today.

Inbox age

inboxMaxAgeDays · default 1

Days a waiting session stays in the "Your turn" inbox.

A session that waits on you longer than this leaves the inbox. It is hidden, not deleted: the map still has it.

Big change

bigChangeLines · default 300

Lines of code after which a message counts as a big change on the map.

Messages whose commits changed at least this many lines get a quiet mark on the map and in the message details. It never hides or ranks anything by itself.

Trailer age

trailerMaxAgeHours · default 6

How old the last message may be for a commit to get its Thought: trailer.

A commit made hours after the last message is probably not about that message, so past this age the commit gets no trailer instead of a wrong one.

Server port

serverPort · default 4747

Port of the local map server on 127.0.0.1.

Change it only when another program already uses the port.