CLI 命令参考

本页内容来自 tansr v0.6.0 的真实 --help 输出(已去除终端控制序列),不做改写。子命令一节的锚点是命令名本身,例如 #serve、#mcp-serve。

子命令	作用
tansr serve	REST + SSE server (–port –host –token)
tansr orchestrate	Embedded tansrd control plane (–port –host –config)
tansr approvals	approval inbox over tansrd API (list / decide <id> –approve|–reject)
tansr policy pull	pull policy bundles from tansrd, verify and install locally (–server/–token/–workspace/–label/–dir)
tansr acp	Agent Client Protocol over stdio (editor integration)
tansr mcp serve	expose built-in tools as an MCP stdio server
tansr doctor	environment diagnosis (config/model/credentials/session storage; –json; –connectors connector self-check, with –tansrd-config/–tansrd-url)
tansr update	check for updates; add –install to apply (npm / enterprise manifest); unsigned artifacts are refused unless –allow-unsigned is confirmed
tansr bg	background task registry (list / log tail; –json)
tansr sessions	session transcript export / storage prune (dry-run by default)
tansr login	sign in on the website (browser) or with an ApiKeyId & ApiKey
tansr logout	sign out on this machine (clear local credentials; best-effort remote device-key revoke)
tansr whoami	show the signed-in identity (public fields only)
tansr init	platform account setup wizard (PAT -> app credentials; –pat or TANSR_PAT when no TTY)
tansr profile	switch between saved identities (list / use <keyId>)
tansr org	join an organization with an activation code (activate <code>)

全局帮助

tansr --help(退出码 0):

Tansr - agent CLI platform for organizations (v0.6.0)

Usage: tansr [flags] | tansr -p "<prompt>" [flags] | tansr <command> [flags] | tansr <command> --help

Modes:
  (default)          interactive terminal session (TUI)
  -p, --prompt       one-shot headless query; add --json for an NDJSON event stream
  serve              REST + SSE server (--port --host --token)
  orchestrate        Embedded tansrd control plane (--port --host --config)
  approvals          approval inbox over tansrd API (list / decide <id> --approve|--reject)
  policy pull        pull policy bundles from tansrd, verify and install locally (--server/--token/--workspace/--label/--dir)
  acp                Agent Client Protocol over stdio (editor integration)
  mcp serve          expose built-in tools as an MCP stdio server
  doctor             environment diagnosis (config/model/credentials/session storage; --json; --connectors connector self-check, with --tansrd-config/--tansrd-url)
  update             check for updates; add --install to apply (npm / enterprise manifest); unsigned artifacts are refused unless --allow-unsigned is confirmed
  bg [show <id>]     background task registry (list / log tail; --json)
 sessions <export|prune> session transcript export / storage prune (dry-run by default)
  login              sign in on the website (browser) or with an ApiKeyId & ApiKey
  logout             sign out on this machine (clear local credentials; best-effort remote device-key revoke)
  whoami             show the signed-in identity (public fields only)
  init               platform account setup wizard (PAT -> app credentials; --pat or TANSR_PAT when no TTY)
  profile            switch between saved identities (list / use <keyId>)
  org                join an organization with an activation code (activate <code>)
  <command> --help   usage, flags and an example for that command

Flags:
  -p, --prompt <text>     run one headless query and exit
  --json                  NDJSON event stream output (headless)
  --output-format <fmt>   output format: text|json|stream-json (json = single aggregated object)
  --input-format <text|ndjson>       Input format; ndjson needs -p + stream-json for same-turn steer/input_status/cancel
 --verbose more progress diagnostics in text mode (no effect in stream-json/json)
  --model <alias>         model alias for this session
  --max-turns <n>         headless turn limit
  --max-budget-usd <usd>  headless session USD budget cap
  --effort <level>        thinking effort: low|medium|high|max (maps to a thinking budget)
  --output-style <name>   output style: default|explanatory|learning or a custom .md style name
  --context-scheme <id>   context governance scheme override: baseline|dev-aggressive|test-tiny or a settings-defined scheme
  --sessions-dir <dir>    session storage root (flag > TANSR_STORAGE_ROOT > settings storage.sessionsDir > ~/.tansr)
  --checkpoints-dir <dir> context checkpoint root (flag > TANSR_CHECKPOINTS_DIR > settings storage.checkpointsDir > <session>/checkpoints)
  --cwd <dir>             session working directory (project config / tools / meta.cwd; must exist; mutually exclusive with -w)
  --resume [id]           resume a saved session (omit id to pick)
  --continue              resume the most recent session in this directory (conflicts with --resume)
  --restore <id>          start from a context checkpoint (headless; replaces the resumed/empty history)
  --bg                    detach the headless query into a background task (requires -p; see: tansr bg)
  -w, --worktree [name]   run in a fresh git worktree under the storage root (kept after the run)
  --permission-mode <m>   initial permission mode (default, acceptEdits, plan, bypassPermissions, auto, dontAsk)
  --allowedTools <rules>  comma-separated allow rules (e.g. "Shell(git *),Read")
  --disallowedTools <rules> comma-separated deny rules (deny always wins)
  --cc-compat             [experimental] Claude Code-style event envelopes (requires stream-json)
  --lang <locale>         UI language (zh-CN, en, ja, ko)
  --theme <name>          TUI theme (dark, light, high-contrast, colorblind)
  --incremental           experimental incremental TUI rendering (off by default)
  --version               print version and exit
  -h, --help              print this help and exit

Environment & config:
  Config layers: .tansr/settings.json (project) and ~/.tansr/settings.json (user)
  Credential fallback: TANSR_TEST_ANTHROPIC_URL / TANSR_TEST_OPENAI_URL + TANSR_TEST_MODEL + TANSR_TEST_API_KEY
  Effort: TANSR_EFFORT=low|medium|high|max (all surfaces; --effort wins in headless)
  Output style: TANSR_OUTPUT_STYLE=<name> (all surfaces; --output-style wins in headless)
  Updates: TANSR_UPDATE_CHANNEL=stable|beta|none, TANSR_UPDATE_PINNED_VERSION, TANSR_NO_UPDATE_CHECK=1
  Create or view API keys at https://www.tansr.com/console/keys

serve

作用(取自全局帮助「Modes」一节):REST + SSE server (–port –host –token)

tansr serve --help(退出码 0):

Usage: tansr serve [flags]

  REST + SSE server for sessions (long-running; Bearer token required, loopback by default)

Flags:
  Flag               Value     Default             Description
  --port             <n>       7433                TCP port to listen on
  --host             <addr>    127.0.0.1           bind address (use 0.0.0.0 to accept external clients)
  --token            <token>   $TANSR_SERVE_TOKEN  Bearer token clients must present (falls back to the env var; missing = refuse to start)
  --model            <alias>   main                default model alias for new sessions
  --lang             <locale>  -                   UI language (zh-CN, en, ja, ko); default from settings / TANSR_LANG
  --context-scheme   <id>      -                   context governance scheme id (flag > settings > baseline)
  --sessions-dir     <dir>     ~/.tansr            session storage root (flag > TANSR_STORAGE_ROOT > settings storage.sessionsDir)
  --checkpoints-dir  <dir>     -                   context checkpoint root (default <session>/checkpoints)
  --cwd              <dir>     .                   working directory for all sessions (must exist; default = current directory)
  --v2               -         $TANSR_SERVE_V2     also mount the /v2 agent session API (off by default; TANSR_SERVE_V2=1 equivalent)

Example:
  tansr serve --port 7433 --token "$TANSR_SERVE_TOKEN"

Global flags and modes: tansr --help

orchestrate

作用(取自全局帮助「Modes」一节):Embedded tansrd control plane (–port –host –config)

tansr orchestrate --help(退出码 0):

Usage: tansr orchestrate [flags]

  run the embedded tansrd control plane in-process (single-machine orchestration)

Flags:
  Flag      Value   Default    Description
  --port    <n>     7420       listening port override (absent = tansrd config; builtin 7420)
  --host    <addr>  127.0.0.1  bind address override (absent = tansrd config; builtin 127.0.0.1)
  --config  <path>  -          extra JSON config file applied on top of the five config layers

Example:
  tansr orchestrate --port 7420 --config ./tansrd.json

Global flags and modes: tansr --help

approvals

作用(取自全局帮助「Modes」一节):approval inbox over tansrd API (list / decide <id> –approve|–reject)

tansr approvals --help(退出码 0):

Usage: tansr approvals list [flags]
       tansr approvals decide <id> --approve|--reject [flags]

  approval inbox over the tansrd API: list pending approvals or decide one

Actions:
  list    list approvals (filter with --status)
  decide  approve or reject one approval by id

Flags:
  Flag       Value                Default         Description
  --status   pending|history|all  pending         which approvals to list
  --approve  -                    -               approve the approval (decide)
  --reject   -                    -               reject the approval (decide)
  --comment  <text>               -               comment attached to the decision
  --actor    <name>               $TANSRD_ACTOR   who is deciding (falls back to the env var)
  --server   <url>                $TANSRD_SERVER  tansrd base URL (falls back to the env var)
  --token    <token>              $TANSRD_TOKEN   tansrd bearer token (falls back to the env var)

Example:
  tansr approvals decide apr_01H --approve --comment "reviewed"

Global flags and modes: tansr --help

policy pull

作用(取自全局帮助「Modes」一节):pull policy bundles from tansrd, verify and install locally (–server/–token/–workspace/–label/–dir)

tansr policy pull --help(退出码 0):

Usage: tansr policy pull [flags]

  pull policy bundles from tansrd, verify their signatures and install them locally

Actions:
  pull  fetch, verify and install the bundles selected for this workspace / labels

Flags:
  Flag         Value    Default            Description
  --server     <url>    $TANSRD_SERVER     tansrd base URL (falls back to the env var)
  --token      <token>  $TANSRD_TOKEN      tansrd bearer token (falls back to the env var)
  --workspace  <name>   default            workspace to pull for (server default when omitted)
  --label      <k=v>    -                  label selector, repeatable (k=v)
  --dir        <dir>    ~/.tansr/policies  install directory for the verified bundles

Example:
  tansr policy pull --server http://127.0.0.1:7420 --label team=core

Global flags and modes: tansr --help

acp

作用(取自全局帮助「Modes」一节):Agent Client Protocol over stdio (editor integration)

tansr acp --help(退出码 0):

Usage: tansr acp [flags]

  Agent Client Protocol agent over stdio (editor integration)

Flags:
  Flag              Value        Default  Description
  --model           <alias>      main     default model alias for new sessions
  --lang            <locale>     -        UI language (zh-CN, en, ja, ko); default from settings / TANSR_LANG
  --context-scheme  <id>         -        context governance scheme id (flag > settings > baseline)
  --allowed-roots   <dir[;dir]>  -        restrict session cwd to these roots (repeatable or path-delimiter separated; absent = no restriction)

Example:
  tansr acp --allowed-roots /work/repo

Global flags and modes: tansr --help

mcp serve

作用(取自全局帮助「Modes」一节):expose built-in tools as an MCP stdio server

tansr mcp serve --help(退出码 0):

Usage: tansr mcp serve

  expose the built-in tools as an MCP server over stdio (for MCP clients / editors)

Flags:
  (no flags)

Example:
  tansr mcp serve

Global flags and modes: tansr --help

doctor

作用(取自全局帮助「Modes」一节):environment diagnosis (config/model/credentials/session storage; –json; –connectors connector self-check, with –tansrd-config/–tansrd-url)

tansr doctor --help(退出码 0):

Usage: tansr doctor [flags]

  diagnose the local setup without calling a model (config layers, provider, credentials, session storage, version); exit 1 on blocking issues

Flags:
  Flag             Value   Default  Description
  --json           -       -        machine-readable JSON report
  --dump-config    -       -        append a per-key config attribution section (which layer set what)
  --connectors     -       -        run the tansrd connector self-check
  --tansrd-config  <path>  -        tansrd config file to check (implies --connectors)
  --tansrd-url     <url>   -        tansrd URL to probe (implies --connectors)

Example:
  tansr doctor --json

Global flags and modes: tansr --help

update

作用(取自全局帮助「Modes」一节):check for updates; add –install to apply (npm / enterprise manifest); unsigned artifacts are refused unless –allow-unsigned is confirmed

tansr update --help(退出码 0):

Usage: tansr update [flags]

  check for a newer release (npm registry or enterprise manifest); install only with --install

Flags:
  Flag              Value  Default  Description
  --install         -      -        download and install the update (default: check and print only)
  --allow-unsigned  -      -        allow an unsigned artifact after an interactive confirmation (requires --install)

Example:
  tansr update --install

Global flags and modes: tansr --help

bg

作用(取自全局帮助「Modes」一节):background task registry (list / log tail; –json)

tansr bg --help(退出码 0):

Usage: tansr bg [list] [flags]
       tansr bg show <id> [flags]
       tansr bg kill <id> [flags]
       tansr bg clean [flags]

  background task registry for headless runs started with --bg (list / show / kill / clean)

Actions:
  list   list registered tasks (default action)
  show   show one task with its log tail
  kill   stop a running task (whole process tree)
  clean  remove finished and stale records (--all also deletes logs)

Flags:
  Flag    Value  Default  Description
  --json  -      -        JSON output
  --all   -      -        clean: also delete log files

Example:
  tansr bg show bg-m0abc12-0f1e

Global flags and modes: tansr --help

sessions

作用(取自全局帮助「Modes」一节):session transcript export / storage prune (dry-run by default)

tansr sessions --help(退出码 0):

Usage: tansr sessions export <id> [flags]
       tansr sessions prune [flags]

  session transcripts: export one (markdown / json, credentials redacted) or prune storage (dry-run by default)

Actions:
  export  export one session transcript by id
  prune   delete old sessions (lists only unless --apply; today and in-use sessions are kept)

Flags:
  Flag              Value    Default  Description
  --format          md|json  md       export format
  --out             <path>   -        export output file (default: stdout)
  --apply           -        -        prune: actually delete (default is dry-run)
  --keep-days       <n>      90       prune: keep sessions newer than n days
  --keep-last       <n>      500      prune: keep the n most recent sessions
  --include-broken  -        -        prune: also remove unreadable session directories

Example:
  tansr sessions prune --keep-days 30 --apply

Global flags and modes: tansr --help

login

作用(取自全局帮助「Modes」一节):sign in on the website (browser) or with an ApiKeyId & ApiKey

tansr login --help(退出码 0):

Usage: tansr login [flags]

  sign in: browser flow on the website by default, or non-interactively with an ApiKeyId & ApiKey

Flags:
  Flag      Value  Default  Description
  --key-id  <id>   -        ApiKeyId for non-interactive login
  --key     <key>  -        ApiKey secret for non-interactive login (never logged)

Example:
  tansr login --key-id ak_01H --key "$TANSR_API_KEY"

Global flags and modes: tansr --help

logout

作用(取自全局帮助「Modes」一节):sign out on this machine (clear local credentials; best-effort remote device-key revoke)

tansr logout --help(退出码 0):

Usage: tansr logout [flags]

  sign out on this machine: clear local credentials and (best effort) revoke the remote device key

Flags:
  Flag           Value  Default  Description
  --keep-remote  -      -        skip the remote revoke; only clear local credentials

Example:
  tansr logout

Global flags and modes: tansr --help

whoami

作用(取自全局帮助「Modes」一节):show the signed-in identity (public fields only)

tansr whoami --help(退出码 0):

Usage: tansr whoami

  show the signed-in identity (public fields only; no secrets)

Flags:
  (no flags)

Example:
  tansr whoami

Global flags and modes: tansr --help

init

作用(取自全局帮助「Modes」一节):platform account setup wizard (PAT -> app credentials; –pat or TANSR_PAT when no TTY)

tansr init --help(退出码 0):

Usage: tansr init [flags]

  platform account setup wizard: verify a PAT, derive app credentials and store them locally

Flags:
  Flag     Value    Default     Description
  --pat    <token>  $TANSR_PAT  personal access token (required when there is no TTY; env var fallback)
  --fresh  -        -           skip reuse of existing credentials and enter a new PAT (switch account)

Example:
  tansr init --pat "$TANSR_PAT"

Global flags and modes: tansr --help

profile

作用(取自全局帮助「Modes」一节):switch between saved identities (list / use <keyId>)

tansr profile --help(退出码 0):

Usage: tansr profile list
       tansr profile use <keyId>

  switch between saved identities (a personal key and any number of organization keys)

Actions:
  list  list saved profiles and mark the active one
  use   activate the profile with this keyId

Flags:
  (no flags)

Example:
  tansr profile use ak_01H

Global flags and modes: tansr --help

org

作用(取自全局帮助「Modes」一节):join an organization with an activation code (activate <code>)

tansr org --help(退出码 0):

Usage: tansr org activate <code>

  join an organization with a member activation code (browser approval; no user credential is stored)

Actions:
  activate  redeem the activation code and bind the organization key

Flags:
  (no flags)

Example:
  tansr org activate ABCD-EFGH

Global flags and modes: tansr --help

本文是否有帮助?

有帮助没帮助