Skip to main content

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.

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:

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)

Source distribution for sessionkit 0.4.0
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)

Table of built distributions (wheels) for sessionkit 0.4.0
File Interpreter ABI Platform Actions
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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page