sessionkit 0.3.1__tar.gz → 0.3.2__tar.gz

sessionkit-0.3.1/README.md → sessionkit-0.3.2/PKG-INFO

@@ -1,3 +1,23 @@
+Metadata-Version: 2.4
+Name: sessionkit
+Version: 0.3.2
+Summary: Session Kit gives your Claude Code sessions voice, mail, a phone line and a tmux sidebar, in one install.
+Author: Mike Bailey
+Author-email: Mike Bailey <mike@sessionkit.ai>
+License-Expression: AGPL-3.0-or-later
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Requires-Dist: click>=8.1
+Requires-Dist: sessionmail>=0.3.2
+Requires-Dist: sessiontools>=0.3.2
+Requires-Dist: sessionphone[media]>=0.3.2
+Requires-Dist: sessionview>=0.3.2
+Requires-Dist: sessionvoice[capture]>=0.3.2
+Requires-Python: >=3.11, <3.15
+Project-URL: Homepage, https://github.com/sessionkit/sessionkit
+Project-URL: Repository, https://github.com/sessionkit/sessionkit
+Description-Content-Type: text/markdown
+
 # Session Kit
 
 Session Kit lets your Claude Code sessions mail each other, hear you and
@@ -46,11 +66,10 @@ You need:
     curl -LsSf https://astral.sh/uv/install.sh | sh
     ```
 
-  - Then open a new terminal. Until you do, `uv` is not on your PATH. Or
-    run:
+  - Then open a new terminal, so `uv` is on your PATH. Or run:
 
     ```bash
-    source ~/.local/bin/env
+    source ~/.zshrc
     ```
 
 - For a call on a Mac: [Homebrew][brew], then ffmpeg from it. A call needs
@@ -64,6 +83,9 @@ You need:
     brew install ffmpeg
     ```
 
+  - Homebrew lists what ffmpeg needs, then asks
+    `Do you want to proceed with the installation? [y/n]`. Press `y`. It
+    goes on at once, with no Return.
   - Then the speech server, then link the phone: the phone bullets below.
   - A call without Homebrew is the workaround case. This guide does not
     cover it.
@@ -82,8 +104,13 @@ kit's plugin and the five family plugins it depends on.
 - **Keep `--python 3.14`.** Without it, uv takes the Python it finds: 3.15,
   where a voice library has no build yet and the install fails, or the
   Command Line Tools' 3.11. The kit is tested on 3.14.
-- **Upgrade with `uv tool upgrade sessionkit`.** It keeps the Python the
-  install chose.
+- To upgrade:
+
+  ```bash
+  uv tool upgrade sessionkit
+  ```
+
+  It keeps the Python the install chose.
 - To reinstall, give the pin again:
 
   ```bash
@@ -102,8 +129,7 @@ kit's plugin and the five family plugins it depends on.
   bot signs its mail to your Claude follows your mail carrier:
   [bot mail signing][phone-signing].
 - **The speech server comes before the phone.** A call hears you through
-  it, so it is installed before you link your phone. Linking is
-  `sessionphone setup`, in [sessionphone][pkg-phone]'s docs.
+  it, so it is installed before you link your phone.
   - No phone: nothing to run now. [Hearing and speaking][hearing]
     installs the speech server with the rest of the voice.
   - A phone: first Homebrew, then ffmpeg, as the call item under "You
@@ -113,6 +139,7 @@ kit's plugin and the five family plugins it depends on.
     brew install ffmpeg
     ```
 
+  - At Homebrew's `[y/n]`, press `y`.
   - Then install the speech server. It builds the server and fetches its
     weights, about 2.9 GB.
 
@@ -120,7 +147,22 @@ kit's plugin and the five family plugins it depends on.
     ears services install --only speech
     ```
 
-  - Then link the phone.
+  - Then link the phone. This makes its account on a public relay and
+    prints the invite link. The name people see in their chat list goes in
+    place of NAME:
+
+    ```bash
+    sessionphone setup --name NAME
+    ```
+
+    A name with a space in it needs quotes, or the shell splits it in two
+    and setup refuses the second word:
+
+    ```bash
+    sessionphone setup --name "Ada Lovelace"
+    ```
+
+  - The rest of linking is in [sessionphone][pkg-phone]'s docs.
 
 - **Then quit Claude Code and start it again**, every window of it, before
   you run anything else.
@@ -129,8 +171,19 @@ A plugin installed from the shell loads only when Claude Code starts, so a
 session that was already open has no plugin commands on its PATH, and no
 plugin hooks.
 
-The three lines leave the ears without the model they listen with. Fetch it
-once:
+Then set up mail. This makes the box `claude`, which your first session
+needs to hear mail and calls:
+
+```bash
+sessionkit setup
+```
+
+- **On a fresh Mac it exits 4, and that is expected.** It leaves two
+  notmuch steps for later: [the manual install][setup] shows its last
+  lines.
+
+The three install lines leave the ears without the model they listen
+with. Fetch it once:
 
 ```bash
 ears install
@@ -174,21 +227,41 @@ starts them ([hearing and speaking][hearing]), refuses with
 Step by step, with every step that needs you marked: [the manual
 install][install].
 
+To see what this Mac is still missing, run the kit's check. It installs
+nothing. It prints one line for each thing the kit needs, and under each
+missing one, the command that adds it:
+
+```bash
+sessionkit doctor
+```
+
+It exits 0 when nothing the kit needs is missing, and 1 when something is.
+The phone bot and the session key are shown, but they never fail it.
+
+- No kit yet, or `sessionkit` will not start? The installer runs the same
+  check. Its address is not live yet. From a clone of this repository,
+  run `bash install.sh --check`. Once the address is live:
+
+  ```bash
+  curl -fsSL https://sessionkit.ai/install.sh | bash -s -- --check
+  ```
+
 ## Quick start
 
 ```bash
 sessionkit --version
 ```
 
-It lists the kit and each family package, with its version:
+It lists the kit and each family package, with its version. Each `X.Y.Z`
+is the version you installed:
 
 ```text
-sessionkit, version 0.3.0
-  sessionmail   0.3.0
-  sessiontools  0.3.0
-  sessionphone  0.3.0
-  sessionview   0.3.0
-  sessionvoice  0.3.0
+sessionkit, version X.Y.Z
+  sessionmail   X.Y.Z
+  sessiontools  X.Y.Z
+  sessionphone  X.Y.Z
+  sessionview   X.Y.Z
+  sessionvoice  X.Y.Z
 ```
 
 Start Claude in a project folder, not in your home folder, where a new
@@ -219,9 +292,9 @@ session start
 
 - **Never a bare `claude`.** Mail to your agent's box, your phone's
   included, reaches only a session started as that agent.
-- **`sessionkit setup` makes the box `claude` first:** [first
-  checks][checks]. Without the box, the first session starts plain too,
-  and its line names the repair:
+- **Without the box `claude`, the first session starts plain too.** The
+  mail setup under Installation makes the box ([first checks][checks]).
+  The line names the repair:
 
   ```text
   session start: starting plain: box claude is missing, so this session will NOT hear Delta messages or calls; repair: message setup --box claude
@@ -302,6 +375,7 @@ Session Kit installs these together:
   `session start <name>`. A plain `claude` session does not hear calls you
   make to it yet.
 - [sessionview][pkg-view]: a tmux sidebar of your projects and your agents.
+  `sessionview` (said "session view").
 
 ## Components
 
@@ -334,7 +408,7 @@ The rules for changing the kit: [AGENTS.md][agents].
 
 ## Status
 
-Alpha, 0.3.1. Tested on macOS 27 on Apple silicon; Linux and Windows are
+Alpha, 0.3.2. Tested on macOS 27 on Apple silicon; Linux and Windows are
 untested. What you may still hit: [known gaps][gaps].
 
 Licence: [AGPL-3.0][licence].
@@ -343,6 +417,7 @@ Licence: [AGPL-3.0][licence].
 [brew]: https://brew.sh
 [install]: INSTALL.md
 [prereqs]: INSTALL.md#1-prerequisites-human
+[setup]: INSTALL.md#2-install-the-kit
 [checks]: INSTALL.md#4-first-checks
 [hearing]: INSTALL.md#5-hearing-and-speaking-it-hears-me-and-speaks
 [mail]: INSTALL.md#mail-between-agents

sessionkit-0.3.1/PKG-INFO → sessionkit-0.3.2/README.md

@@ -1,23 +1,3 @@
-Metadata-Version: 2.4
-Name: sessionkit
-Version: 0.3.1
-Summary: Session Kit gives your Claude Code sessions voice, mail, a phone line and a tmux sidebar, in one install.
-Author: Mike Bailey
-Author-email: Mike Bailey <mike@sessionkit.ai>
-License-Expression: AGPL-3.0-or-later
-License-File: LICENSE
-Classifier: Development Status :: 3 - Alpha
-Requires-Dist: click>=8.1
-Requires-Dist: sessionmail>=0.3.1
-Requires-Dist: sessiontools>=0.3.1
-Requires-Dist: sessionphone[media]>=0.3.0
-Requires-Dist: sessionview>=0.3.0
-Requires-Dist: sessionvoice[capture]>=0.3.0
-Requires-Python: >=3.11, <3.15
-Project-URL: Homepage, https://github.com/sessionkit/sessionkit
-Project-URL: Repository, https://github.com/sessionkit/sessionkit
-Description-Content-Type: text/markdown
-
 # Session Kit
 
 Session Kit lets your Claude Code sessions mail each other, hear you and
@@ -66,11 +46,10 @@ You need:
     curl -LsSf https://astral.sh/uv/install.sh | sh
     ```
 
-  - Then open a new terminal. Until you do, `uv` is not on your PATH. Or
-    run:
+  - Then open a new terminal, so `uv` is on your PATH. Or run:
 
     ```bash
-    source ~/.local/bin/env
+    source ~/.zshrc
     ```
 
 - For a call on a Mac: [Homebrew][brew], then ffmpeg from it. A call needs
@@ -84,6 +63,9 @@ You need:
     brew install ffmpeg
     ```
 
+  - Homebrew lists what ffmpeg needs, then asks
+    `Do you want to proceed with the installation? [y/n]`. Press `y`. It
+    goes on at once, with no Return.
   - Then the speech server, then link the phone: the phone bullets below.
   - A call without Homebrew is the workaround case. This guide does not
     cover it.
@@ -102,8 +84,13 @@ kit's plugin and the five family plugins it depends on.
 - **Keep `--python 3.14`.** Without it, uv takes the Python it finds: 3.15,
   where a voice library has no build yet and the install fails, or the
   Command Line Tools' 3.11. The kit is tested on 3.14.
-- **Upgrade with `uv tool upgrade sessionkit`.** It keeps the Python the
-  install chose.
+- To upgrade:
+
+  ```bash
+  uv tool upgrade sessionkit
+  ```
+
+  It keeps the Python the install chose.
 - To reinstall, give the pin again:
 
   ```bash
@@ -122,8 +109,7 @@ kit's plugin and the five family plugins it depends on.
   bot signs its mail to your Claude follows your mail carrier:
   [bot mail signing][phone-signing].
 - **The speech server comes before the phone.** A call hears you through
-  it, so it is installed before you link your phone. Linking is
-  `sessionphone setup`, in [sessionphone][pkg-phone]'s docs.
+  it, so it is installed before you link your phone.
   - No phone: nothing to run now. [Hearing and speaking][hearing]
     installs the speech server with the rest of the voice.
   - A phone: first Homebrew, then ffmpeg, as the call item under "You
@@ -133,6 +119,7 @@ kit's plugin and the five family plugins it depends on.
     brew install ffmpeg
     ```
 
+  - At Homebrew's `[y/n]`, press `y`.
   - Then install the speech server. It builds the server and fetches its
     weights, about 2.9 GB.
 
@@ -140,7 +127,22 @@ kit's plugin and the five family plugins it depends on.
     ears services install --only speech
     ```
 
-  - Then link the phone.
+  - Then link the phone. This makes its account on a public relay and
+    prints the invite link. The name people see in their chat list goes in
+    place of NAME:
+
+    ```bash
+    sessionphone setup --name NAME
+    ```
+
+    A name with a space in it needs quotes, or the shell splits it in two
+    and setup refuses the second word:
+
+    ```bash
+    sessionphone setup --name "Ada Lovelace"
+    ```
+
+  - The rest of linking is in [sessionphone][pkg-phone]'s docs.
 
 - **Then quit Claude Code and start it again**, every window of it, before
   you run anything else.
@@ -149,8 +151,19 @@ A plugin installed from the shell loads only when Claude Code starts, so a
 session that was already open has no plugin commands on its PATH, and no
 plugin hooks.
 
-The three lines leave the ears without the model they listen with. Fetch it
-once:
+Then set up mail. This makes the box `claude`, which your first session
+needs to hear mail and calls:
+
+```bash
+sessionkit setup
+```
+
+- **On a fresh Mac it exits 4, and that is expected.** It leaves two
+  notmuch steps for later: [the manual install][setup] shows its last
+  lines.
+
+The three install lines leave the ears without the model they listen
+with. Fetch it once:
 
 ```bash
 ears install
@@ -194,21 +207,41 @@ starts them ([hearing and speaking][hearing]), refuses with
 Step by step, with every step that needs you marked: [the manual
 install][install].
 
+To see what this Mac is still missing, run the kit's check. It installs
+nothing. It prints one line for each thing the kit needs, and under each
+missing one, the command that adds it:
+
+```bash
+sessionkit doctor
+```
+
+It exits 0 when nothing the kit needs is missing, and 1 when something is.
+The phone bot and the session key are shown, but they never fail it.
+
+- No kit yet, or `sessionkit` will not start? The installer runs the same
+  check. Its address is not live yet. From a clone of this repository,
+  run `bash install.sh --check`. Once the address is live:
+
+  ```bash
+  curl -fsSL https://sessionkit.ai/install.sh | bash -s -- --check
+  ```
+
 ## Quick start
 
 ```bash
 sessionkit --version
 ```
 
-It lists the kit and each family package, with its version:
+It lists the kit and each family package, with its version. Each `X.Y.Z`
+is the version you installed:
 
 ```text
-sessionkit, version 0.3.0
-  sessionmail   0.3.0
-  sessiontools  0.3.0
-  sessionphone  0.3.0
-  sessionview   0.3.0
-  sessionvoice  0.3.0
+sessionkit, version X.Y.Z
+  sessionmail   X.Y.Z
+  sessiontools  X.Y.Z
+  sessionphone  X.Y.Z
+  sessionview   X.Y.Z
+  sessionvoice  X.Y.Z
 ```
 
 Start Claude in a project folder, not in your home folder, where a new
@@ -239,9 +272,9 @@ session start
 
 - **Never a bare `claude`.** Mail to your agent's box, your phone's
   included, reaches only a session started as that agent.
-- **`sessionkit setup` makes the box `claude` first:** [first
-  checks][checks]. Without the box, the first session starts plain too,
-  and its line names the repair:
+- **Without the box `claude`, the first session starts plain too.** The
+  mail setup under Installation makes the box ([first checks][checks]).
+  The line names the repair:
 
   ```text
   session start: starting plain: box claude is missing, so this session will NOT hear Delta messages or calls; repair: message setup --box claude
@@ -322,6 +355,7 @@ Session Kit installs these together:
   `session start <name>`. A plain `claude` session does not hear calls you
   make to it yet.
 - [sessionview][pkg-view]: a tmux sidebar of your projects and your agents.
+  `sessionview` (said "session view").
 
 ## Components
 
@@ -354,7 +388,7 @@ The rules for changing the kit: [AGENTS.md][agents].
 
 ## Status
 
-Alpha, 0.3.1. Tested on macOS 27 on Apple silicon; Linux and Windows are
+Alpha, 0.3.2. Tested on macOS 27 on Apple silicon; Linux and Windows are
 untested. What you may still hit: [known gaps][gaps].
 
 Licence: [AGPL-3.0][licence].
@@ -363,6 +397,7 @@ Licence: [AGPL-3.0][licence].
 [brew]: https://brew.sh
 [install]: INSTALL.md
 [prereqs]: INSTALL.md#1-prerequisites-human
+[setup]: INSTALL.md#2-install-the-kit
 [checks]: INSTALL.md#4-first-checks
 [hearing]: INSTALL.md#5-hearing-and-speaking-it-hears-me-and-speaks
 [mail]: INSTALL.md#mail-between-agents

{sessionkit-0.3.1 → sessionkit-0.3.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sessionkit"
-version = "0.3.1"
+version = "0.3.2"
 description = "Session Kit gives your Claude Code sessions voice, mail, a phone line and a tmux sidebar, in one install."
 readme = "README.md"
 license = "AGPL-3.0-or-later"
@@ -9,11 +9,11 @@ classifiers = ["Development Status :: 3 - Alpha"]
 requires-python = ">=3.11,<3.15"
 dependencies = [
     "click>=8.1",
-    "sessionmail>=0.3.1",
-    "sessiontools>=0.3.1",
-    "sessionphone[media]>=0.3.0",
-    "sessionview>=0.3.0",
-    "sessionvoice[capture]>=0.3.0",
+    "sessionmail>=0.3.2",
+    "sessiontools>=0.3.2",
+    "sessionphone[media]>=0.3.2",
+    "sessionview>=0.3.2",
+    "sessionvoice[capture]>=0.3.2",
 ]
 
 [[project.authors]]
@@ -51,4 +51,7 @@ dev = [
 ]
 
 [tool.pytest.ini_options]
-testpaths = ["tests"]
+testpaths = [
+    "tests",
+    "dark-launch/tests",
+]

{sessionkit-0.3.1 → sessionkit-0.3.2}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "sessionkit"
-version = "0.3.1"
+version = "0.3.2"
 description = "Session Kit gives your Claude Code sessions voice, mail, a phone line and a tmux sidebar, in one install."
 readme = "README.md"
 license = "AGPL-3.0-or-later"
@@ -18,6 +18,9 @@ requires-python = ">=3.11,<3.15"
 # and docs call on: `sessionkit setup` asks sessiontools 0.3.1's
 # `session agent default`, and INSTALL.md describes sessionmail 0.3.1's
 # one-run mail setup.
+# All five are floored at 0.3.2: the family is released together, and an older
+# copy of one package beside the others splits its state between the old
+# and new folders.
 # sessionphone with its media extra: the bot, calls and `sessionphone web` need it.
 # sessionvoice with its capture extra, so the ears can hear the room.
 # This is the RULED list, kept in tests/_ruled_deps.py with the ruling;
@@ -25,11 +28,11 @@ requires-python = ">=3.11,<3.15"
 # uv.lock drift from it.
 dependencies = [
     "click>=8.1",
-    "sessionmail>=0.3.1",
-    "sessiontools>=0.3.1",
-    "sessionphone[media]>=0.3.0",
-    "sessionview>=0.3.0",
-    "sessionvoice[capture]>=0.3.0",
+    "sessionmail>=0.3.2",
+    "sessiontools>=0.3.2",
+    "sessionphone[media]>=0.3.2",
+    "sessionview>=0.3.2",
+    "sessionvoice[capture]>=0.3.2",
 ]
 
 [project.urls]
@@ -80,4 +83,4 @@ dev = [
 ]
 
 [tool.pytest.ini_options]
-testpaths = ["tests"]
+testpaths = ["tests", "dark-launch/tests"]

{sessionkit-0.3.1 → sessionkit-0.3.2}/src/sessionkit/cli.py

@@ -5,6 +5,7 @@ from importlib.metadata import PackageNotFoundError, version
 
 import click
 
+from sessionkit import doctor as kit_doctor
 from sessionkit import setup as operator_setup
 
 CTX = {"help_option_names": ["-h", "--help"]}
@@ -154,3 +155,42 @@ def setup(
     for line in outcome.lines:
         click.echo(line, err=outcome.code != 0)
     raise SystemExit(outcome.code)
+
+
+@main.command(context_settings=CTX)
+@click.option(
+    "--no-speech",
+    is_flag=True,
+    help="Leave the speech server and the ears out: their rows do not fail.",
+)
+def doctor(no_speech: bool) -> None:
+    """Check this Mac for what the kit needs, and install nothing.
+
+    One line per thing, found or missing, and under each missing one the
+    command that adds it. The rows the installer checks come from the
+    installer itself: this runs the install.sh the kit ships, with --check.
+    Then three rows of its own: the mail hooks (needed), the phone bot
+    (optional) and the session key (information only).
+
+    It is read-only: it writes no file of its own and starts and stops
+    nothing. The only network it reaches itself is the speech server on
+    127.0.0.1:8890, which it probes, and its brew reads download nothing.
+    The tools it asks keep their own files in your home, and may use their
+    own network: in an empty home, brew, uv and claude make their caches,
+    and claude, asked for its plugins, reaches Anthropic's API over HTTPS.
+    INSTALL.md section 4, in
+    https://github.com/sessionkit/sessionkit, names each file.
+
+    On a Mac without the kit, or where this command will not start, the
+    installer runs the same check:
+
+    \b
+        curl -fsSL https://sessionkit.ai/install.sh | bash -s -- --check
+
+    From a clone of the kit, the same: bash install.sh --check
+
+    Exit 0 nothing the kit needs is missing, 1 something is (each missing
+    row says what to run), 2 usage, 3 this Mac cannot be checked (not macOS,
+    or run as root).
+    """
+    raise SystemExit(kit_doctor.run(no_speech=no_speech, echo=click.echo))