How it works

From idea to shipped code in four steps.

Task detail view with agent-drafted spec and chat refinement
Task detail view with agent-drafted spec and chat refinement (desktop)
1

Describe a task, agent writes the spec

Describe what you want in a sentence. The agent researches your codebase — reads files, understands architecture, finds relevant patterns — then drafts a structured spec with scope, approach, and acceptance criteria. Refine through conversation until the spec is right. The spec is the contract: both you and the agent agree on what to build before any code is written.

2

Agent builds it

The agent works in an isolated git worktree — reading your codebase, writing code, running tests, and fixing issues autonomously. Choose which agent backend handles implementation: Claude Code, Codex, or Gemini. Watch every step in real time: file reads, edits, shell commands, test runs.

Verification results with pass and fail status
Verification results with pass and fail status (desktop)
3

Verify the work

Before approval, run verification checks — tests, UI screenshots, or custom checks. See pass/fail results with full artifacts: screenshots, test output, logs. Evidence the work meets your criteria.

4

Review and ship

See the full diff — every file changed, lines added and removed. Approve to squash merge into a single clean commit. Reject to discard. The next task in the queue starts automatically.

The full lifecycle

Every task follows this loop — from idea through spec, code, verification, and back again.

Longshot task lifecycle Describe what you want Drafting spec Happy with spec? Yes Queue for execution Agent working Happy with code? Looks good Verify Passes? Pass Approve & commit Spec auto-updates No Refine Needs changes Fix Fail

Then keep going

Queue up more tasks and multiple agents work through them simultaneously, each in its own isolated worktree. Check back whenever you want.

Parallel agent execution Run multiple agents at once with --max-parallel-agents. Each task gets its own worktree — parallel work without conflicts.
Push notifications Get notified when a diff is ready to review. No need to keep checking.
Branch management Create, switch, merge, and push branches. Manage your workflow from anywhere.

Full audit trail

Every task, every agent action, every verification — committed to git as part of your project history.

Know what was done and why Task specs, agent run logs, and conversations are all stored in .longshot/ and committed alongside your code.
Generate change notes Each approved task is a clean commit with clear scope. Task specs double as change documentation for release notes and handoffs.
Verification evidence Screenshots, test results, and check output are saved per-task. Proof that work was verified before it shipped.
curl -fsSL https://longshothq.com/install.sh | sh

Install in seconds, then run longshot in your project directory.

Install Now