clawdie/layered-soul
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
layered-soul/skills/freebsd-cost-optimization/SKILL.md
Sam & Claude 61a2b9393e fix(skills): make freebsd-cost-optimization a SKILL.md skill dir 
Move skills/freebsd/freebsd-cost-optimization.md to
skills/freebsd-cost-optimization/SKILL.md so the Colibri importer (skills/**/SKILL.md)
picks it up. Import smoke now loads 10 skills.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-14 02:26:36 +02:00

1.7 KiB
Raw Blame History

name description
freebsd-cost-optimization How to use Colibri's fast/smart/max cost modes to minimize DeepSeek API spending on FreeBSD deployments

FreeBSD Cost Optimization

Cost modes

Colibri supports three cost modes that control context window usage:

  • fast — tighter context budget, compaction triggers earlier. Use for high-volume, low-importance tasks (log scanning, status checks).
  • smart (default) — balanced budget. Most agent sessions should run here.
  • max — preserves full context, compaction only when absolutely necessary. Use for complex multi-step tasks where losing history would cause rework.

When to escalate

The daemon auto-escalates fast→smart→max when the current session budget is exceeded or compaction cannot free enough space. This is intent, not a policy engine — the thresholds are fixed in colibri-daemon/src/cost.rs:

Mode Session budget Uncompacted turns Tool result limit
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

  • Set colibri_cost_mode="fast" in /etc/rc.conf for disposable worker agents; the FreeBSD rc.d script exports it as COLIBRI_COST_MODE.
  • Use the MCP write-gated colibri_set_cost_mode tool, or the daemon socket {"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.