Skip to content

tally adapter

The adapter marketplace: list, install, create, and validate harness adapters. Built-ins (claude-code, pi, codex) are compiled in and verified; community adapters are declarative adapter.toml manifests installed under <tally_home>/adapters/ and reach the session verbs (session export --harness <name> / session materialize --into <name>) but not the launch verbs (built-ins-only for beta)

usage
tally adapter <COMMAND>

List all adapters: built-ins (verified) + installed community manifests

usage
tally adapter list

Install a community adapter from a git URL or a local path.

The manifest is parsed + validated BEFORE anything is written, and installation refuses manifests containing shell-exec patterns unless --allow-shell (review the manifest first).

usage
tally adapter install [OPTIONS] <SOURCE>
<SOURCE>
A git clone URL, a directory containing adapter.toml, or the file itself
--allow-shell
Install even if the manifest contains shell-exec patterns (only after you have reviewed and trust it)

Remove an installed community adapter (built-ins refuse)

usage
tally adapter remove <NAME>
<NAME>
The adapter name (see tally adapter list)

Search the community adapter registry

usage
tally adapter search <TERM>
<TERM>
Substring matched against name, harness, and author

Scaffold ./tally-adapter-<name>/adapter.toml with a commented template

usage
tally adapter create <NAME>
<NAME>
The new adapter's name ([a-z0-9-]+)

Validate a manifest: schema + shell-pattern scan + the PAC round-trip conformance smoke (materialize a marker context into a temp dir, extract it back, assert the task recovers). Exits non-zero on FAIL

usage
tally adapter validate <PATH>
<PATH>
A directory containing adapter.toml, or the file itself