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.

docs: say how shared sessions arrive and that prune exists

Erencd590443b114
diff --git a/README.md b/README.md
index 5c2830f..f206fb8 100644
--- a/README.md
+++ b/README.md
@@ -94,7 +94,8 @@ including the option that was rejected.*
- **No server, no account**: it runs on your machine. Nothing leaves it unless you say so: `cogit
init` asks whether to share the record (titles, decisions and reasons) with your team. If you
do, `git push` sends it to your own repository, outside your branches, so it never shows up in
- a pull request or `git status`. Your chats stay local. Key and token patterns are redacted.
+ a pull request or `git status`. Your chats stay local, `cogit prune` deletes old sessions, and
+ key and token patterns are redacted.
- **The agent gets the context too**: a new session starts where the last one left off, and
before editing a file the agent hears what was already tried and rejected there. It works
alongside memory tools; it doesn't replace them.
diff --git a/docs/guide/troubleshooting.md b/docs/guide/troubleshooting.md
index 024d49f..58e7bff 100644
--- a/docs/guide/troubleshooting.md
+++ b/docs/guide/troubleshooting.md
@@ -20,6 +20,15 @@ cogit doctor --json
cogit ties its record to commits, so it needs git. Run `git init` (or work in a clone), then
`cogit init` again.
+## A teammate's sessions do not appear
+
+In a project that shares its record, they arrive in two steps: they send with `git push`, you
+receive with `git pull`, and cogit shows them the next time it runs. If they still do not appear,
+run `cogit doctor` on both machines: its record line says when a send or download failed and
+why. An SSH key that needs a passphrase has to be in `ssh-agent`, since the record is sent in the
+background where nothing can ask for it. If your project keeps its record private, nothing
+is shared; `cogit config git` shows which it is.
+
## Nothing is recorded
1. **Is the plugin on in this session?** Run `/plugin` in Claude Code and look for cogit. A