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.11
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.11.tar.gz | 102.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pairwit-0.0.11-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 228.2 kB
Release files / pairwit-0.0.11.tar.gz
| Download URL | pairwit-0.0.11.tar.gz |
|---|---|
| Size | 102.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
980d898ac2b5d7a13d53c2d98e9165356fc06f800d86981e7a37a8144f0f0c36
|
|
BLAKE2b-256 checksum How to use checksums |
8d9bdddee941caa08159e823616fb6405bb3516fbb965fab7bee402318c3b277
|
| 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.11-py3-none-any.whl
| Download URL | pairwit-0.0.11-py3-none-any.whl |
|---|---|
| Size | 125.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
24199f7d40b9728f89b18a4eba19fe414b0c41e4a44edbb1a1cde3b6474af204
|
|
BLAKE2b-256 checksum How to use checksums |
345b5a10967ee1aeb598dbc1ceedefaf3615a1b1169a0dc442e175f0ce0506ee
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.4
|