# Workflow Local

Run a team workflow unattended with the local driver.

- Repository: https://github.com/Tencent/teamai-cli (5729 stars)
- Category: AI and agents
- License: see repository
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add Tencent/teamai-cli --skill workflow-local -g -a claude-code -y`
Codex: `npx skills add Tencent/teamai-cli --skill workflow-local -g -a codex -y`
Cursor: `npx skills add Tencent/teamai-cli --skill workflow-local -g -a cursor -y`
Gemini CLI: `npx skills add Tencent/teamai-cli --skill workflow-local -g -a gemini-cli -y`

## Description

Run a team workflow unattended with the local driver. Use in CI or a cloud agent, when a describe reply routed the run to the local driver, or to continue a run on this machine without a coding session.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Run a team workflow unattended

The local driver runs a whole run in one process on this machine: each command step as a process, each prompt step through a headless tool. Nobody is asked anything while it runs, so every answer the run needs is decided before it starts.

## When

- A CI job or a cloud agent runs the workflow.
- `teamai workflow start --describe <name> --driver skill` answered `ask.kind: local`: a coding session cannot run some step, and `ask.reason` says which.
- A run continues on this machine without a coding session: after a retry, an answer, a stopped driver, or a session that handed it over.

## Run it

1. Run `teamai workflow start <name> --describe` and read the inputs it lists.
2. Start the run: `teamai workflow start <name> --driver local`, with the inputs as one JSON object in `--inputs`. `teamai workflow start --help` lists the other options, such as answering optional approvals and picking the prompt tool.
3. To continue a run that stopped, run `teamai workflow resume <run>`.

The command exits when the run ends: 0 when it succeeded, 1 when it failed or was cancelled. A failed run names each failed step, its message and its `teamai workflow retry` command on stderr. Done when it has exited and the outcome, the failing step's message and the pull requests the run opened are reported where the person reads them: the job log, or your reply.

## Approvals

Without a terminal, nobody answers a gate during the run:

- A required approval fails its step `hitl_required`, and so does the run.
- With `--auto-approve`, or the member's `workflows.auto_approve`, an optional approval is answered yes and a choice takes its default.
- Without either, an optional approval is skipped, and a choice fails `hitl_required`.

## From an agent session

The rest: https://github.com/Tencent/teamai-cli/blob/HEAD/skill-data/workflow-local/SKILL.md