Skip to content

Update AGENTS.md for current loop workflows #49

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
axeldelafosse merged 1 commit into from
Mar 27, 2026
Merged

Update AGENTS.md for current loop workflows #49

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 4 additions & 1 deletion AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,15 +6,18 @@ Please keep the code dead-simple and keep the `src/loop/main.ts` file under 150
- Check lint/types/style: `bun run check`
- Run tests: `bun test`
- Build executable: `bun run build`
- Install global binary/aliases: `bun run install:global`
- Cut a patch release: `bun run release:patch`

# Repo Workflows

- Plain-text prompts auto-create `PLAN.md` first, then optionally run `--review-plan`; if you are changing planning behavior, keep that flow aligned.
- Default CLI behavior is paired Claude/Codex execution with persisted run state under `~/.loop/runs`; preserve `--run-id` / `--session` resume behavior when changing startup, planning, or loop flow.
- Running `loop` with no args opens the live panel for active sessions, loop-owned paired runs, and tmux sessions; keep panel-only changes separate from task-running changes when possible.
- Running `loop` with no args starts the paired interactive tmux workspace (`--tmux`); `loop dashboard` opens the live panel for active sessions, loop-owned paired runs, and tmux sessions. Keep panel-only changes separate from task-running changes when possible.
- `--tmux` and `--worktree` are first-class execution modes. In paired mode, tmux opens Claude/Codex side-by-side and resumed run ids should stay aligned with matching tmux/worktree names.
- `--claude-only` and `--codex-only` switch out of the default paired flow; keep single-agent behavior working when changing shared CLI parsing or resume logic.
- `loop update` / `loop upgrade` are supported manual update commands for installed binaries; source runs should continue to rely on `git pull`.
- When options are provided without a prompt, `loop` reuses `PLAN.md` if it already exists; keep that fallback aligned with the plain-text prompt planning flow.

# Coding Standards

Expand Down
Loading