Pairwit

The coding agent that asks before it acts.

A cool terminal desk — Plan when you think, Build when you’re ready.
Writes and bash pause for Once · Session · Always · Deny as soon as the path (or command) is known.

pairwit.dev · Guide · PyPI · GitHub

Install

macOS / Linux

pip install -U pairwit && pairwit

Windows

py -m pip install -U pairwit && py -m pairwit

Public alpha — APIs and UX may change. Feedback welcome.

On first launch, Pairwit opens a guided setup: provider → API key → model → connection check. Keys are saved to ~/.pairwit/.env.

Why Pairwit

What it is — and isn’t

• Is: a consent-first coding agent for your terminal
• Is: Plan/Build, early approvals, sessions, /schedule, framed chat wells + turn analytics
• Isn’t: a full IDE or silent autopilot

Quick start

cd your-project
pairwit

Then ask anything. Attach with Ctrl+O, mention a file with @, switch Plan/Build with Tab, open Files / Editor from the header chips (or ⌃B / ⌃E).

Project rules live in .pairwit.md. Home config: ~/.pairwit/.

Desk at a glance

• You — framed prompt well; Pairwit — plain reply on paper
• Thought briefly while the model works; per-turn ↑/↓ tokens · time · cost under the reply
• Tool wells with path-first titles and soft diff highlighting
• Approval gate for write_file / edit_file / bash before the change lands

From a checkout

pip install -e .
pairwit
# or
python -m pairwit

pairwit/           # Python package
  ai/              # providers / streaming
  agent/           # coding loop + events
  tools/           # builtins + MCP
  domain/          # sessions, permissions, prompts
  tui/             # Textual app + theme + widgets/
  core.py          # attachments / mentions
docs/              # product docs
site/              # pairwit.dev (Cloudflare Pages)

Formerly Torso (and before that Greywit / Astro).

License

MIT — see the repo for details.