clawdie/layered-soul
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Merge pull request 'docs: correct FreeBSD cost mode skill details (Sam & Codex)' (#3) from fix/freebsd-cost-skill-accuracy into main

Browse source 
Reviewed-on: #3
This commit is contained in:
clawdie 2026-06-13 23:45:13 +02:00
commit 5e3fb02fb0
1 changed files with 14 additions and 10 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

24
skills/freebsd/freebsd-cost-optimization.md
View file

@ -17,18 +17,22 @@ Colibri supports three cost modes that control context window usage:
## When to escalate ## When to escalate
The daemon auto-escalates fast→smart→max when compaction alone cannot keep the The daemon auto-escalates fast→smart→max when the current session budget is
session within budget. This is intent, not a policy engine — the thresholds are exceeded or compaction cannot free enough space. This is intent, not a policy
fixed in `colibri-daemon/src/cost.rs`: engine — the thresholds are fixed in `colibri-daemon/src/cost.rs`:
- fast: budget 4K tokens, compact at 80% | Mode | Session budget | Uncompacted turns | Tool result limit |
- smart: budget 16K tokens, compact at 75% | ----- | --------------- | ----------------- | ----------------- |
- max: budget 64K tokens, compact at 90% | fast | 500,000 bytes | 5 | 4,000 bytes |
| smart | 2,000,000 bytes | 20 | 16,000 bytes |
| max | 8,000,000 bytes | 100 | unlimited |
## Operator tips ## Operator tips
- Set `COLIBRI_COST_MODE=fast` in `/etc/rc.conf` for disposable worker agents. - Set `colibri_cost_mode="fast"` in `/etc/rc.conf` for disposable worker agents;
- Use `colibri set-cost-mode smart` via the CLI for interactive sessions. the FreeBSD rc.d script exports it as `COLIBRI_COST_MODE`.
- Monitor cache-hit rate via `colibri status` — if it drops below 50%, - Use the MCP write-gated `colibri_set_cost_mode` tool, or the daemon socket
consider escalating to the next mode. `{"cmd":"set-cost-mode","mode":"smart"}`, for runtime intent changes.
- Treat runtime `set-cost-mode` as acknowledgement-only until persistent live
config mutation is designed; verify the active mode with `colibri status`.
- On FreeBSD live USB, the default is `smart` to balance cost and capability. - On FreeBSD live USB, the default is `smart` to balance cost and capability.