TENET — Documentation

Create agents tailored to your project’s specific improvement goals.

Interactive Setup

tenet peter agent create

Walks you through: name, metric, eval script, scope files, time budget.

Manual Setup

Write an eval script in eval/:

#!/usr/bin/env bash
CLI_DIR="${AGENT_WORKTREE:-$HOME/your-project}"
# ... measure your metric ...
echo '{"my_metric": 0.42}'

Create agent config in .tenet/agents/my-agent.toml:

[agent]
name = "my-agent"
scope = "quality"
metric = "my_metric"
direction = "maximize"
time_budget_seconds = 300
description = "What this agent should do to improve my_metric"

[eval]
script = "eval/my-eval.sh"
data = "eval/fixtures/my-agent-baseline.jsonl"

[constraints]
scope_files = ["src/**/*.ts"]
max_file_changes = 3

Test the eval manually:

bash eval/my-eval.sh
# {"my_metric": 0.42}

Run the agent:

tenet peter agent my-agent --rounds 1

Tips

Start with one metric — focused agents beat general-purpose ones
Verify gradient — run the eval, confirm the metric isn’t at ceiling
Narrow scope — fewer scope_files = more focused changes
Short rounds — 3-5 minutes per round is ideal for iteration speed