xonecas.io
7814
Ta

tiny-c-agent / files

tiny-c-agent / AGENTS.md

1.9 KB
1# Project file for agents
2
3## tiny-c-agent (`tiny` for short)
4
5A fast, minimal and config first agent for your terminal.
6
7## References
8
9- `../mini-coder` - A very similar implementation in typescript. An example do not blindly copy.
10
11## Some guardrails
12
13- **Write original code.** Other coding agents are behavioral references only.
14- **No loop limits.** No max turns, tool calls, token budgets, or agent-imposed
15  timeouts. The user's ability to interrupt is the limit.
16- **Config-first.** Every user-facing behavior that can vary comes from config
17  with a sane default.
18- **Minimal context.** The model sees the configured system prompt plus
19  explicitly opted-in resource files — never reminders, hidden blocks, or
20  harness meta-text.
21- **The agent never imports the TUI.** Headless and TUI are two projections of
22  the same agent events; the TUI owns no agent or provider semantics.
23- **Respect linux/unix coventions**. Both for storing configs and state, as well as making sure the head
24  less mode is scriptable.
25
26## Invariants
27
28- Sessions are append-only JSONL, one message per line, fsynced on
29  write. Never rewrite or delete committed lines. A persistence failure stops
30  the turn.
31- The loop has no compaction, no retries, and no meta-messages between steps.
32  Provider errors surface as-is, never masked or summarized.
33- Three LLM tools, matching mini-coder: `read`, `edit`, and `bash`.
34- Interruption: ESC politely pauses at the next step boundary; Ctrl+C cancels the
35  turn (abort the request, kill the tool's process group, persist the aborted
36  message); Ctrl+C (or CTRL+D) exits on an empty draft. Completed side effects are never
37  undone.
38- Diagnostics are local only. No telemetry, no hidden stalls.
39
40## Working agreement
41
42- Trace the real data flow before designing; apply guards at the narrowest
43  boundary.
44- Keep the diff small. Do not opportunistically refactor or harden adjacent code.
45- Do not add tests unless explicitly asked; verify manually.