TerMinal

Compatibility launcher for the code-review agent. Delegates a GitHub/GitLab PR review to Codex: deterministic preflight does recon, then Codex scores six axes into one artifact at .TerMinal/reviews/<pr>/<sha>.md (v2) or .reviews/<pr>/<sha>.md (legacy v1). Use on /code-review or 'review this PR'.

Human-review digest for a PR/MR — chunks the diff into a noise-filtered, risk-ranked, code-first review surface (green/red diffs, 🟢/🟡/🔴, design-decision callouts) WITHOUT abstracting the code away. Deterministic chunker + one bounded codex pass. Sits alongside /code-review (the gate) and /iterate (tests). Use on /digest or 'digest this PR for review'. Renders in TerMinal.

Audit docs/ and ~/.claude/docs/ for rot — broken refs, stale runbooks, ADR contradictions, architecture drift, orphan CLAUDE.md. Reports only; never auto-edits. Use on /document-audit or 'check doc health'.

Sweep recent changes and propose doc updates (ADRs, runbooks, learnings, architecture, per-folder CLAUDE.md), one candidate at a time. Use on /document, 'capture decisions', or natural post-commit/post-PR pauses.

FORCE-MODE hotfix: smallest patch → commit → push DIRECTLY to main → follow-up ticket. Needs TERMINAL_FORCE_MAIN=1 (hook-enforced). Use on /emergency-fix or 'this is breaking prod' / 'hotfix' / 'we need to revert now'.

Enqueue a one-off TerMinal automation-inbox request (can create Activity, tickets, HITL, agent runs, or background tasks). Use on /enqueue-request or to queue a durable local automation request.

Continuous autonomous orchestrator: reconcile, route tickets by owner agent, run stacked PR/MR passes, optionally discover/refill, park HITL, never merge. Use on /factory or 'work the backlog autonomously'.

Capture durable project or global knowledge into TerMinal's Knowledge Base. Use on /knowledge, when saving links/media/snippets/references, or when the user asks to remember useful context visually.

Reconcile tickets/backlog with reality: close tickets whose PRs merged, scrub merged URLs, sweep status drift. Edits ticket files only, never merges. Use after merging a stack or whenever PRs have landed.

Convert .agents/agents.json entries into the script-first shape — one <id>.sh + <id>.json per agent. Non-destructive (agents.json untouched). Use on /migrate-agents or to convert prompt-style agents into bash scripts.

Design or implement a durable TerMinal automation-inbox source (adapter, poller, webhook bridge, file watcher). Use on /new-inbox-source or when building a service that repeatedly enqueues requests.

Create or update TerMinal Knowledge Base entries in repo .TerMinal/knowledge.json or global ~/.config/TerMinal/knowledge.json. Use on /new-knowledge or when the user asks to save links, media, files, snippets, or durable references.

Create a TerMinal cron schedule from a natural-language request — appends a launchd-backed entry to ~/.config/TerMinal/schedules.json. Use on /new-schedule or 'run this agent on a cadence'.

Create or update a TerMinal quick snippet (repo .TerMinal/snippets.json or global). Use on /new-snippet or wanting a reusable quick prompt / one-click launcher item.

On-demand AFK Telegram bridge: send completion/blocker pings and receive replies via a background listener that wakes the session. OFF by default. Use on /notify, going AFK, or steering from Telegram.

Take owner-compatible backlog tickets from idea to open PR/MR: knowledge phase → branch/worktree → TDD → checks → follow-up tickets → push/open/link. Does not auto-run code review. Use on /pr-creation or 'start work on a ticket'.

FORCE-MODE: git revert HEAD on main, run the suite, push directly. Needs TERMINAL_FORCE_MAIN=1 (hook-enforced). Use on /revert-main or 'revert main' / 'undo the last commit' / 'roll back HEAD'.

Deterministic local security checks — dependency CVE audit (bun/npm) by default, optional SAST (semgrep) and opt-in gitleaks — summarized for code-review's Security axis. Use on /security-scan or as a pre-push gate.

Open a work session: allocate an id, seed a live session doc by scanning the repo for relevant tickets/state, and generate a TDD-first checklist. Use on /session-start "<goal>" or to kick off work.

Autonomous AFK mode: build a stack of owner-scoped PRs/MRs, then batch-review them to the bar. Human merges. Use on /stacked-mr or 'stack PRs'.

Add or edit repo-specific TerMinal sidebar widgets (shell commands the terminal polls) via .TerMinal/widgets.json. Use on /terminal-widget or to surface repo state (counts, status, metrics) in the sidebar.

Delegate an ad-hoc test run to Codex and report results in chat (no artifact) — the cheap inner-loop step; the code-review agent is the checkpoint. Use on /test-suite or 'run the tests'.

Create and manage in-repo backlog tickets (.TerMinal/backlog/NNNN-slug.md in v2, backlog/NNNN-slug.md in legacy v1); atomic ids, list/update/close. Portable. Use on /ticket, 'file/list/close a ticket', or describing work to track.

FORCE-MODE: main CI is red — apply the narrowest of revert bad SHA / pin dep / skip documented-flaky test, pushed directly to main. Needs TERMINAL_FORCE_MAIN=1. Use on /unblock-ci or 'main CI is broken' / 'green main'.

Continuous autonomous orchestrator: reconcile, route tickets by owner agent, run stacked PR/MR passes, optionally discover/refill, park HITL, never merge. Use on /factory or 'work the backlog autonomously'.

Create and manage in-repo backlog tickets (.TerMinal/backlog/NNNN-slug.md in v2, backlog/NNNN-slug.md in legacy v1); atomic ids, list/update/close. Portable. Use on /ticket, 'file/list/close a ticket', or describing work to track.

Continuous autonomous orchestrator: reconcile, route tickets by owner agent, run stacked PR/MR passes, optionally discover/refill, park HITL, never merge. Use on /factory or 'work the backlog autonomously'.

Take owner-compatible backlog tickets from idea to open PR/MR: knowledge phase → branch/worktree → TDD → checks → follow-up tickets → push/open/link. Does not auto-run code review. Use on /pr-creation or 'start work on a ticket'.

Open a work session: allocate a session id, seed a live session doc at sessions/NNNN-slug/session.md by scanning the repo for everything relevant (in-scope tickets, research, tools, prior sessions, git/PR state), and generate a TDD-first checklist. The session doc is the central live state for the session. Use when the user runs /session-start "<goal>" or asks to kick off a work session.

Create and manage in-repo backlog tickets (.TerMinal/backlog/NNNN-slug.md in v2, backlog/NNNN-slug.md in legacy v1); atomic ids, list/update/close. Portable. Use on /ticket, 'file/list/close a ticket', or describing work to track.

On-demand AFK Telegram bridge for this repo: send completion/blocker pings to the user and receive their replies via a background listener that wakes the session when a message arrives. OFF by default — armed only when the user says they're AFK / asks to be pinged. Invokable as /notify <message>. Use when the user goes AFK, asks to steer from Telegram, or runs /notify.

Run a long-running, self-driving agent loop (the 'let the model drive' pattern) with separated planner/generator/evaluator roles, an on-disk contract, and taste scoring. Use when the user runs /loop-driver, says 'loop on this', 'let it run for a while', 'set up a generator/evaluator loop', or wants one agent to keep building-and-grading against a rubric until it converges. This is the operator entry point that sets up state and drives the cycle; the loop-planner, loop-implementer, and loop-evaluator skills are the three roles it coordinates.

The generator role in a /loop-driver. Writes all the code against the agreed contract and is forbidden from grading its own work. Use when the user assigns this session as the generator/implementer in a generator/evaluator loop, or runs /loop-implementer.

The planner role in a /loop-driver. Turns a vague human goal into a gradable contract of testable assertions and never touches code. Use when the user assigns this session as the planner in a generator/evaluator loop, or runs /loop-planner.

The evaluator role in a /loop-driver. Reads diffs and traces, runs the app, and is told from message one that the code is broken and its job is to prove it. Grades the contract and scores taste. Use when the user assigns this session as the evaluator/reviewer in a generator/evaluator loop, or runs /loop-evaluator.

Compatibility launcher for the code-review agent. Delegate a GitHub PR review to Codex via codex exec. Codex runs the test suite first (the gate), scores six axes, and writes ONE combined artifact IN THIS REPO under .reviews/<pr>/<sha>.md plus findings.json/suggestions.json. Use when the user runs /code-review, asks to review a PR, or is preparing a PR for human merge.

Enter vibe mode — fast, gates-off exploration in a disposable worktree to generate breadth and signal, never shipped directly. Use when the user says /vibe, 'vibe this', 'explore fast, skip the gates', 'prototype N approaches', or wants throwaway iteration to learn the shape of a problem before building it for real. NOT for production work — that's quality mode (the default).

Run a scheduled cadence agent from an .agents/<kind>.md spec — isolated worktree, SHA-gated no-op on re-runs, then reports findings or proposes a ticket+MR. Use on /check <kind>, a scheduled-agent run, or wiring a launchd schedule.

Add or update TerMinal Knowledge Base entries backed by the lyonzin/knowledge-rag local RAG MCP server. Use when the user wants category-specific RAG knowledge, semantic/vector search over docs, URL/document ingestion into the Knowledge Base, or help configuring the Knowledge Base tab's RAG item type.

Create or update a TerMinal agent from a natural-language request — writes a script-first .agents/<id>.sh + <id>.json sidecar. Use on /new-agent, 'create an agent', or wanting a reusable button/scheduled agent.