History

add log.csv session log to the standard

Kris Yotam committed 3 months ago

Commit eb5e4dd1 parent 63ae8e04 files · +41 −3Browse files

Unified · Split

4 files
  1. .gitignore +1 −0
  2. README.md +20 −3
  3. template/README.md +19 −0
  4. template/log.csv +1 −0
.gitignore+1−0
@@ -1 +1,2 @@
1models.env1models.env
2/log.csv
README.md+20−3
@@ -16,7 +16,7 @@ it can shell out to the others. · 15 unmodified lines
162. Every agent's system file gets **exactly one line** pointing at it:162. Every agent's system file gets **exactly one line** pointing at it:
17 17
18 ```18 ```
19 Shared primitives (hosts/SSH, subagent CLIs, models.env) live in `~/.model/`. Read `~/.model/README.md` on launch.19 Shared primitives (hosts/SSH, subagent CLIs, models.env) live in `~/.model/`. Read `~/.model/README.md` on launch and append a row to `~/.model/log.csv` when the session ends.
20 ```20 ```
21 21
22 Append it to `~/.claude/CLAUDE.md`, `~/.codex/AGENTS.md`,22 Append it to `~/.claude/CLAUDE.md`, `~/.codex/AGENTS.md`,
@@ -37,10 +37,27 @@ read Markdown, so the format is Markdown. · 14 unmodified lines
37| `hosts.md` | Every machine: IPs, SSH command, sudo, what runs there |37| `hosts.md` | Every machine: IPs, SSH command, sudo, what runs there |
38| `subagents.md` | How to invoke every other agent CLI headlessly |38| `subagents.md` | How to invoke every other agent CLI headlessly |
39| `models.env` | Shared env, sectioned per agent, `chmod 600` |39| `models.env` | Shared env, sectioned per agent, `chmod 600` |
40| `log.csv` | Session log every agent appends to |
40 41
41Templates for all four are in [`template/`](template/). Copy them, fill them42Templates for all five are in [`template/`](template/). Copy them, fill them
42with your own facts, and never commit the result.43with your own facts, and never commit the result.
43 44
45## The session log
46
47One CSV, every agent, one row per session, appended when the session ends:
48
49```
50date,company,model,description,resume
512026-07-28,anthropic,fable 5,added the session log to the standard,claude --resume 9cbb2d13-ef46-450b-a999-a4aeb82aff82
522026-07-28,xai,grok-4.5,swept the quant repo for dead code,grok --resume 41c9
53```
54
55CSV rather than Markdown so one table serves every agent and you can still
56filter it: `grep -i ',anthropic,' ~/.model/log.csv` or
57`awk -F, '$3=="fable 5"'`. The `resume` column is whatever that CLI needs to
58pick the session back up, so one row is enough to get back into any past
59session from any agent.
60
44## Adding a primitive61## Adding a primitive
45 62
46New topic gets a new `<topic>.md` and one row in the local `README.md` table.63New topic gets a new `<topic>.md` and one row in the local `README.md` table.
@@ -79,7 +96,7 @@ cp template/* ~/.model/ · 32 unmodified lines
79mv ~/.model/models.env.example ~/.model/models.env96mv ~/.model/models.env.example ~/.model/models.env
80chmod 600 ~/.model/models.env97chmod 600 ~/.model/models.env
81 98
82LINE='Shared primitives (hosts/SSH, subagent CLIs, models.env) live in `~/.model/`. Read `~/.model/README.md` on launch.'99LINE='Shared primitives (hosts/SSH, subagent CLIs, models.env) live in `~/.model/`. Read `~/.model/README.md` on launch and append a row to `~/.model/log.csv` when the session ends.'
83for f in ~/.claude/CLAUDE.md ~/.codex/AGENTS.md ~/.gemini/GEMINI.md \100for f in ~/.claude/CLAUDE.md ~/.codex/AGENTS.md ~/.gemini/GEMINI.md \
84 ~/.grok/AGENTS.md ~/.config/opencode/AGENTS.md; do101 ~/.grok/AGENTS.md ~/.config/opencode/AGENTS.md; do
85 mkdir -p "$(dirname "$f")"102 mkdir -p "$(dirname "$f")"
template/README.md+19−0
@@ -14,6 +14,25 @@ exactly one line pointing here. Nothing else duplicates this content. · 13 unmodified lines
14| `hosts.md` | Every machine: IPs, SSH, sudo, what runs there |14| `hosts.md` | Every machine: IPs, SSH, sudo, what runs there |
15| `subagents.md` | How to invoke any other agent CLI headlessly |15| `subagents.md` | How to invoke any other agent CLI headlessly |
16| `models.env` | Shared env, sectioned per agent. `chmod 600`. |16| `models.env` | Shared env, sectioned per agent. `chmod 600`. |
17| `log.csv` | Session log. Every agent appends one row when a session ends. |
18
19## Session log
20
21Append one row to `log.csv` at the end of a session:
22
23```
24date,company,model,description,resume
252026-07-28,anthropic,fable 5,ported the model standard to src,claude --resume 9cbb2d13-ef46-450b-a999-a4aeb82aff82
26```
27
28- `date` — `YYYY-MM-DD`.
29- `company` — provider, lowercase: `anthropic`, `openai`, `xai`, `google`.
30- `model` — the model as a human names it, e.g. `fable 5`, `gpt-5.5`.
31- `description` — one line, what the session did.
32- `resume` — the full command to resume it, or the bare session id if the CLI has no resume.
33
34Quote any field containing a comma. One table, so `grep -i ',anthropic,'` or
35`awk -F, '$3=="fable 5"'` filters it.
17 36
18## Rules37## Rules
19 38
template/log.csv+1−0
@@ -0,0 +1 @@
1date,company,model,description,resume