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 requirement sources for durable context instead of putting long specifications 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

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>

Merge or delete the branch after review.