Tacitt CLI
Local session review, privacy decisions and reviewed export/Send for coding agents.
Requires Node.js >=24.19.0 <25 and npm. Package acquisition does not need an npm
login or organization membership.
npx --yes @gitroll/tacitt-cli@latest skill.install
Then use $tacitt in a fresh Codex conversation or /tacitt in Claude Code.
Select one client with --agent codex or --agent claude; use --scope project
for a workspace-local installation. The installer pairs the Skill with this exact
CLI version, preserves verified previous release assets for existing tasks, and
reports unmanaged-file collisions. Installation alone starts no scan and resets
no source logs, state or existing exports.
Tacitt has three surfaces: the Skill, the Skill panel that the Skill opens, and
the CLI commands the Skill runs (tacitt --help lists them). Running tacitt
with no command prints how to start the Skill.
For a local export without Send, run these CLI commands in order. tacitt stands for
npx --yes @gitroll/tacitt-cli@latest. Each command prints JSON. Take runId,
revision, settingsVersion and dictionaryRevision from the previous command's output,
because each step raises the revision. slots picks workspace ZIPs by position. The
echo ... | tacitt ... --input - form works in sh and PowerShell; in cmd.exe, save the JSON
to a file and pass --input FILE. Manual upload to Passport from the CLI is not available yet.
tacitt workflow.startDiscovery # operationId
tacitt operation.wait <operationId>
tacitt workflow.getCurrent # runId, revision
echo '{"protocolVersion":1,"runId":"<runId>","expectedRevision":<revision>}' | tacitt workflow.chooseMethod --input -
echo '{"protocolVersion":1,"runId":"<runId>","expectedRevision":<revision>,"expectedSettingsVersion":<settingsVersion>,"mode":"configured","changes":[]}' | tacitt processing.batch --input -
echo '{"protocolVersion":1,"runId":"<runId>","expectedRevision":<revision>}' | tacitt workflow.reviewPending --input -
echo '{"protocolVersion":1,"runId":"<runId>","expectedRevision":<revision>,"expectedDictionaryRevision":"<dictionaryRevision>"}' | tacitt workflow.package --input - --async
tacitt operation.wait <operationId>
tacitt delivery.list # result id
echo '{"resultId":"<id>","slots":[0],"artifact":"primary","output":"export.zip"}' | tacitt delivery.issue --input -
The processing.batch step applies the configured cleanup and redaction. Without it, the
export is the original session content with no redaction or anonymization.
Global sensitive terms and the bundle library are set through the CLI only.
sensitiveTerms.replace replaces the whole list; take revision from sensitiveTerms.get
("empty" before the first save). bundleLibrary.save takes effect at the next CLI start.
tacitt sensitiveTerms.get
echo '{"expectedRevision":"<revision>","terms":["Acme Corp","project-x"]}' | tacitt sensitiveTerms.replace --input -
tacitt bundleLibrary.get
echo '{"directory":"/absolute/path/to/bundles"}' | tacitt bundleLibrary.save --input -
The echo '...' | lines work in sh and PowerShell. In cmd.exe, drop the single quotes and
put | right after the JSON:
echo {"expectedRevision":"<revision>","terms":["Acme Corp","project-x"]}| tacitt sensitiveTerms.replace --input -
The native Skill presents decisions in a focused panel. Source consent precedes classification and privacy analysis. The current model provider receives frozen original main conversations and retained tool results before privacy masking; this workflow is not local-only. Send separately authorizes packaging/upload of the selected reviewed material to the signed-in Tacitt account. Keep session data and panel capability URLs private.
State from incompatible previews is not silently migrated. Keep the pinned CLI for old tasks and use a separate state directory when required; installing the Skill does not erase private payload files or import them into a fresh store. Windows verification remains partly advisory; prefer macOS or Linux and review reported platform limitations.
Tacitt retains UNLICENSED package metadata. Bundled Web dependency notices are
in dist/web/THIRD_PARTY_LICENSES.md. Source and current guidance are maintained
at gitroll-dev/tacitt-cli. The
repository contains proprietary source; public visibility does not grant an
open-source license. All rights are reserved; reuse requires separate permission
from the rights holders.
For a custom Passport deployment, set SESS_PILOT_PASSPORT_WEB_ORIGIN to its trusted profile website origin alongside the custom API origin. The published-ID lookup uses the declared web origins for the standard production and development APIs.