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.
Metadata
Release files for pairwit 0.0.8
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.8.tar.gz | 98.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pairwit-0.0.8-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 219.5 kB
Release files / pairwit-0.0.8.tar.gz
| Download URL | pairwit-0.0.8.tar.gz |
|---|---|
| Size | 98.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
137df1c44c33bad16761c8480afb4776e24c89e681414a97cfd48fa4a91f2d14
|
|
BLAKE2b-256 checksum How to use checksums |
f5145cdf0a3b4168a7fc7f5ff9947fd0a5ad846547175f5faf09dff1f2efaad9
|
| 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.8-py3-none-any.whl
| Download URL | pairwit-0.0.8-py3-none-any.whl |
|---|---|
| Size | 121.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4e50bd1c33bbb8ff1ea249369e917c9c4538865afd54297f71b1f21e4a71c0e4
|
|
BLAKE2b-256 checksum How to use checksums |
f00099423c1ac35bf7fd4c527e9686f01cac1e25414039d39c102bf5a7dd6664
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.4
|