docs: verify model ids and worktree launch
This commit is contained in:
@@ -7,3 +7,4 @@
|
||||
*.db-wal
|
||||
result
|
||||
result-*
|
||||
/worktrees
|
||||
|
||||
@@ -137,28 +137,63 @@ across two providers keeps a single provider's rate limits or an outage from
|
||||
stalling the whole queue, and keeps one model's blind spots from shaping the
|
||||
entire codebase.
|
||||
|
||||
| Difficulty | Models | Spawn |
|
||||
|---|---|---|
|
||||
| `difficulty/hard` | Fable 5 | `aoe add <path> --tool claude --extra-args "--model claude-fable-5" -l` |
|
||||
| | Sol | `aoe add <path> --tool codex --extra-args "-m gpt-5.6-sol" -l` |
|
||||
| `difficulty/moderate` | Opus 5 | `aoe add <path> --tool claude --extra-args "--model claude-opus-5" -l` |
|
||||
| | Sol, low effort | `aoe add <path> --tool codex --extra-args "-m gpt-5.6-sol -c model_reasoning_effort=low" -l` |
|
||||
| `difficulty/easy` | Sonnet 5 | `aoe add <path> --tool claude --extra-args "--model claude-sonnet-5" -l` |
|
||||
| | Terra | `aoe add <path> --tool codex --extra-args "-m gpt-5.6-terra" -l` |
|
||||
| `difficulty/trivial` | Terra | `aoe add <path> --tool codex --extra-args "-m gpt-5.6-terra" -l` |
|
||||
| Difficulty | Models | `--tool` | `--extra-args` |
|
||||
|---|---|---|---|
|
||||
| `difficulty/hard` | Fable 5 | `claude` | `--model claude-fable-5` |
|
||||
| | Sol | `codex` | `-m gpt-5.6-sol` |
|
||||
| `difficulty/moderate` | Opus 5 | `claude` | `--model claude-opus-5` |
|
||||
| | Sol, low effort | `codex` | `-m gpt-5.6-sol -c model_reasoning_effort="low"` |
|
||||
| `difficulty/easy` | Sonnet 5 | `claude` | `--model claude-sonnet-5` |
|
||||
| | Terra | `codex` | `-m gpt-5.6-terra` |
|
||||
| `difficulty/trivial` | Terra | `codex` | `-m gpt-5.6-terra` |
|
||||
|
||||
Alternate within a tier rather than draining one model first, so a bad run is
|
||||
visible early instead of after ten issues.
|
||||
|
||||
Use `-w <branch> -b` to put each session in its own git worktree, which is what
|
||||
makes parallel issues safe.
|
||||
### Launching a session
|
||||
|
||||
Caveats worth resolving before a long unattended run:
|
||||
Verified working against this repo:
|
||||
|
||||
- `gpt-5.6-terra` is confirmed — it is the default in `~/.codex/config.toml`.
|
||||
`gpt-5.6-sol` is inferred from the sibling naming and unverified.
|
||||
- `-c model_reasoning_effort=low` is the documented codex config-override form
|
||||
but has not been exercised here.
|
||||
```sh
|
||||
aoe add /home/naps62/tea/arr \
|
||||
--title "arr-42-torznab" \
|
||||
--worktree issue/42-torznab --new-branch \
|
||||
--tool codex --extra-args "-m gpt-5.6-sol" \
|
||||
--launch
|
||||
```
|
||||
|
||||
Things that are easy to get wrong:
|
||||
|
||||
- **The worktree path comes from `--title`, not from the branch.** That command
|
||||
creates `/home/naps62/tea/arr/worktrees/arr-42-torznab` on branch
|
||||
`issue/42-torznab`. Give every session a distinct title or the second one
|
||||
collides.
|
||||
- `--new-branch` is required alongside `--worktree` for a branch that does not
|
||||
exist yet. Without it, `aoe` expects the branch to be there already.
|
||||
- The base branch defaults to the repo default (`main`). Pass `--base-branch`
|
||||
only when stacking on an in-flight branch.
|
||||
- YOLO mode came out enabled without passing `-y`, from profile config. Check
|
||||
that is what you want before an unattended run.
|
||||
- `aoe remove <title>` keeps the worktree. Use `--delete-worktree`, or clean up
|
||||
with `git worktree remove --force` — and note `aoe` leaves the worktree
|
||||
*locked*, so `git worktree unlock` comes first.
|
||||
|
||||
### Model IDs, verified
|
||||
|
||||
All five were checked against the live CLIs on 2026-08-22, with a deliberately
|
||||
bogus ID as a control to prove the check discriminates:
|
||||
|
||||
| ID | Tool | Result |
|
||||
|---|---|---|
|
||||
| `claude-fable-5` | claude | accepted |
|
||||
| `claude-opus-5` | claude | accepted |
|
||||
| `claude-sonnet-5` | claude | accepted |
|
||||
| `gpt-5.6-sol` | codex | accepted |
|
||||
| `gpt-5.6-terra` | codex | accepted, and the default in `~/.codex/config.toml` |
|
||||
|
||||
`-c model_reasoning_effort="low"` was exercised on a real `codex exec` run and
|
||||
accepted. The bogus control (`gpt-5.6-nonesuch`) failed with HTTP 400, and
|
||||
`claude-bogus-9` was rejected by the CLI.
|
||||
|
||||
**`area/web` issues run on Fable 5 regardless of their difficulty label**, since
|
||||
they go through the `impeccable` skill and the UI is the reason this project
|
||||
|
||||
Reference in New Issue
Block a user