Quickstart

Goal: install the sptc plugin, watch it bring up spt-core for you, and confirm your session is reachable — in under ten minutes. You need Claude Code and a shell (bash on macOS/Linux, Git Bash on Windows).

1. Add the marketplace and install the plugin

From Claude Code:

/plugin marketplace add SaberMage/cplugs
/plugin install sptc@cplugs

Then restart the Claude Code session so the plugin’s SessionStart hook runs and populates the session environment.

2. Let it install spt-core for you

On that first start, the plugin’s bootstrap installs spt-core if it is not already present — this is the invisible-installer step, nothing for you to run. Confirm it landed:

spt --version

If spt is not yet on your PATH in this shell, it was installed to ~/.local/bin/spt (macOS / Linux) or %LOCALAPPDATA%\spt-core\bin\spt.exe (Windows); open a fresh shell and try again.

3. Confirm your session is reachable

Each Claude Code session resolves its own agent identity. Check it:

spt whoami

That prints this session’s perch id (resolved from $OWL_SESSION_ID / $SPT_AGENT_ID). A printed id means the adapter wired your session into Spacetime’s messaging fabric.

What works today, and what is coming

This is an early build. The plumbing above — install, invisible spt-core bootstrap, identity — is operative now. The /sptc:* skills (send, ready, live, commune, and the rest) ship as skeletons: their operative instructions are delivered by the adapter at invocation time rather than baked into the plugin, and some are still being wired. Each skill says in place whether it is operative yet.

Next, read Harness contract to see exactly how Claude Code hook events map onto the spt binary.