Session Kit
Session Kit gives your Claude Code sessions a voice, a phone line and a mailbox. From the people who brought you VoiceMode.
curl -fsSL https://sessionkit.ai/install.sh | bash
This repo is the kit's home: the installer, the manual steps and the docs.
Features
- Voice. Your session hears the room and answers aloud.
- A phone line. Text or ring your session from Delta Chat on your phone.
- Mail. Agents mail each other, and an idle agent wakes when mail lands (mail between agents).
- A crew. One agent starts another and hands it the work.
- Talk. Watch the conversation live in a browser.
Quick start
After the install, do what its last screen lists (sign in to Claude Code once), then start your first session, in whatever folder you're in:
session start
Ask Claude to call you. It shows a QR code: scan it with your phone and follow the steps to install Delta Chat. Then you can text or ring your session. Asking Claude to call you, or ringing your session, is when you agree to be heard, and recorded if recording is on.
What it installs
Session Kit installs the family in one go: five packages, each with its Claude Code plugin, and the Settings page.
- sessionmail: mail for agent memory and communication (the paper).
- sessiontools: your live sessions, and starting new ones.
- sessionvoice: the ears hear the room; the mouth speaks.
- sessionphone: a phone line to your session, over Delta Chat.
- sessionview: a tmux sidebar of your projects and agents.
- settled: the kit's settings page, on your own Mac.
Every command answers --help. Commands, services and folders:
components.
Requirements
- macOS on Apple silicon (tested on an M5 MacBook Air, 16 GB, macOS 27)
- Linux (preliminary testing; no install steps yet)
- WSL
- Windows
You need:
- Homebrew
- uv
- Claude Code
- About 8 GB of free disk
The installer adds any of the first three that are missing.
Installation
The one line at the top checks your Mac, lists what it will add, and asks before it installs anything. Rather run each step yourself? With the requirements in place (the speech server is about 4 GB):
brew install tmux ffmpeg notmuch
uv tool install --python 3.14 sessionkit
claude plugin marketplace add sessionkit/sessionkit
claude plugin install sessionkit@sessionkit
ears install
ears services install --agent claude
sessionkit setup
pager settings hooks on
Then quit Claude Code, every window, so the plugins load. Check it with
sessionkit doctor. More detail: step by step. To remove it:
uninstall.
Already using VoiceMode? It keeps working. Use either one, or both side by side.
Configuration
Each package's settings: configuration. How they stack: settings.
Logs
Where each log is: logs. Which to read for a symptom:
troubleshooting. Restarting a service: service.
Health: sessionkit doctor.
Development
make install, then make check. The rules: AGENTS.md.
Working across the family? With your clones of the five packages beside this
one, make install-dev installs the whole kit from them (DRY_RUN=1 first
to see the command).
Status
Alpha, 0.4.0. A new release most Sundays. Known gaps · Licence AGPL-3.0.
Metadata
Release files for sessionkit 0.4.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| sessionkit-0.4.0.tar.gz | 74.1 kB | Without provenance | Details for sessionkit-0.4.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| sessionkit-0.4.0-py3-none-any.whl | Python 3 | none | any | Details for sessionkit-0.4.0-py3-none-any.whl |
Total release size: 150.2 kB
Release files / sessionkit-0.4.0.tar.gz
| Download URL | sessionkit-0.4.0.tar.gz |
|---|---|
| Size | 74.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c837b021e125c321f57fbd45f9dabd51865d557d4bf15cb52d1095a6e77b2e82
|
|
BLAKE2b-256 checksum How to use checksums |
82458b5e85baec8af551633c416629518d4b5721b2a9e8b0401781d8239f6a7a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.4 {"installer":{"name":"uv","version":"0.13.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / sessionkit-0.4.0-py3-none-any.whl
| Download URL | sessionkit-0.4.0-py3-none-any.whl |
|---|---|
| Size | 76.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6f7521e40932246893b41544d6b54b2c1105051967c3f3bd2d23f63ed1660284
|
|
BLAKE2b-256 checksum How to use checksums |
cbacccf4b9fa9f93422104c98b5f9cba763f3513c9fd7dcebe19236c65d164f0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.4 {"installer":{"name":"uv","version":"0.13.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for sessionkit 0.4.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.