Skip to main content

Configure agents

Agents use product context and workspace credentials to propose quality changes on branches.

Add an LLM credential​

  1. Open workspace settings.
  2. Open Credentials.
  3. Create an LLM credential for your provider.
  4. Test the credential.

Credentials are write-only after creation.

Create an agent configuration​

  1. Open a product.
  2. Open Agents.
  3. Choose an agent type.
  4. Select Configure.
  5. Provide a name, JSON inputs, and credentials.
  6. Enable the configuration.

Keep agent inputs small and explicit. Use product branches and spec sources for durable context instead of putting long documents into agent input JSON.

Run an agent from the CLI​

List agent types:

tiden agent types --format text

List configs:

tiden agent config list --product-id <product-id> --format text

Start a run:

tiden agent run --config-id <config-id>

Follow status:

tiden agent run-status <run-id> --follow

Review generated output​

Agent output should appear as a generated branch. Open Branches, inspect the change review, resolve conflicts, and merge only the accepted changes.

Set up intent capture​

Intent capture records coding-agent sessions and distills them into reviewable branches.

Install hooks from the repository root:

tiden intent install

Check hook status:

tiden intent status --format text

If you use Claude Code auto mode, also Allow tiden in Claude Code, so the hooks' tiden commands are not denied.

Distill the latest captured session:

tiden intent distill --latest --format text

Preview the generated branch:

tiden branch merge-preview \
  --product-id <product-id> \
  --name intent/<date>-<slug>

Tiden merges an intent branch by itself about 24 hours after the last pull request of that work merges. To review it first, merge it yourself or hold the automatic merge. Close the branch if you do not want its changes but want to keep the record. Delete it to discard the changes.