Pairwit
The coding agent that asks before it acts.
A calm terminal desk — Plan when you think, Build when you’re ready.
Writes and bash pause for Once · Session · Always · Deny.
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
| Consent-first | Mutating tools ask by default. Remember Once / Session / Always in .pairwit.permissions. |
| Plan / Build | Plan to reason read-only; Tab into Build when you’re ready to change files. |
| One desk | Chat, Files, Editor, and /schedule in a local Textual TUI — not a cloud watcher. |
| Your models | Moonshot (Kimi), OpenAI, Anthropic, OpenRouter, DeepSeek, Ollama, and custom OpenAI-compatible endpoints. |
What it is — and isn’t
- Is: a consent-first coding agent for your terminal
- Is: Plan/Build, approvals, sessions,
/schedule - 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.
Project rules live in .pairwit.md. Home config: ~/.pairwit/.
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.
1 maintainer
Metadata
1 maintainer
Release files for pairwit 0.0.9
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pairwit-0.0.9.tar.gz | 98.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pairwit-0.0.9-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 220.4 kB
Release files / pairwit-0.0.9.tar.gz
| Download URL | pairwit-0.0.9.tar.gz |
|---|---|
| Size | 98.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
038b66db17ec4d1e4a0e1d21b25656a80f488a6d53bea61b5fb7d40ef12e88a7
|
|
BLAKE2b-256 checksum How to use checksums |
5320a7c2184cbea546f08823069d448d3e5fd537425d9c361b903880525d5cdf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.4
|
Release files / pairwit-0.0.9-py3-none-any.whl
| Download URL | pairwit-0.0.9-py3-none-any.whl |
|---|---|
| Size | 121.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
238cb09f9e59f3c397b9f27c05377ac903b3af226548148913aee0ef596986d9
|
|
BLAKE2b-256 checksum How to use checksums |
d4eb024679a24f4564c98673264ebb7e247bc3ba0379e60ab511c918213e5d02
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.4
|
