Skip to main content

Set up the CLI

The tiden CLI is the recommended way to connect repositories, CI, agents, and local automation to Tiden.

Install​

macOS with Homebrew:

brew install --cask qase-tms/tap/tiden

Linux or macOS without Homebrew:

curl -fsSL https://tiden.ai/install.sh | bash

Windows PowerShell:

irm https://tiden.ai/install.ps1 | iex

Verify:

tiden version

Authorize with browser setup​

Run:

tiden setup

The setup flow:

  1. Creates a setup session.
  2. Opens the Tiden app in your browser.
  3. Lets you approve the CLI.
  4. Stores baseUrl and apiToken in ~/.tiden/config.json.
  5. Lets you select a workspace.
  6. Can bind the current repository to a product and install intent hooks.

Validate the token:

tiden config verify

Manual configuration​

Use manual configuration for CI or locked-down environments.

tiden config set baseUrl https://app.tiden.ai
printf '%s' "$TIDEN_API_TOKEN" | tiden config set apiToken -
tiden config verify

The CLI resolves configuration in this order:

  1. ~/.tiden/config.json
  2. Environment variables: TIDEN_BASE_URL, TIDEN_API_TOKEN, TIDEN_WORKSPACE_ID, TIDEN_TIMEOUT
  3. CLI flags: --base-url, --api-token, --workspace-id, --timeout

Bind a repository to a product​

From the repository root:

tiden product bind --product-id <product-id>

Binding writes local product metadata so intent capture and other repo-aware commands can resolve the product without repeated flags.

Text and JSON output​

Commands output JSON by default:

tiden product list --workspace-id <workspace-id>

Use text output for local reading:

tiden product list --workspace-id <workspace-id> --format text

Install intent hooks​

After binding a repository:

tiden intent install
tiden intent status --format text

This wires Tiden-managed hooks for supported coding agents and a git fallback hook. See Configure agents for the full intent capture workflow.