Workflow & CLI
Run single actions from GitHub Actions workflows and from the giik CLI
Workflow & CLI
You can run single actions in two ways: from a GitHub Actions workflow (e.g. a scheduled job or manual trigger) or from the giik CLI locally.
From a GitHub Actions workflow
Add a job that sets single-action and any required inputs (single-action-issue, single-action-version, etc.):
jobs:
run-check-progress:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: landamessenger/git-board-flow@master
with:
token: ${{ secrets.PAT }}
single-action: check_progress_action
single-action-issue: '123'
Use workflow_dispatch to run on demand, or trigger from another event. See Configuration for all inputs.
From the CLI (giik)
Build the CLI from the git-board-flow repo, then run it from any repo that has origin pointing to GitHub (or from the same repo):
nvm use 20
npm install
npm run build
# From the repo you want to analyze:
node build/cli/index.js <command> [options]
# Or if giik is on PATH:
giik <command> [options]
Commands that mirror single actions
| CLI command | Single action equivalent | Required option | Description |
|---|---|---|---|
setup | initial_setup | — | Labels, issue types, verify access |
check-progress | check_progress_action | -i <issue> | Progress check on demand |
detect-potential-problems | detect_potential_problems_action | -i <issue> [-b <branch>] | Bugbot: detect potential problems, report on issue and PR (OpenCode) |
recommend-steps | recommend_steps_action | -i <issue> | Recommend steps from issue (OpenCode) |
think | think_action | -q "<question>" | Deep code analysis (OpenCode) |
copilot | (CLI only) | -p "<prompt>" | AI assistant: analyze/modify code (OpenCode Build) |
Common options: -t / --token (PAT), -d / --debug, --opencode-server-url, --opencode-model. You can also set PERSONAL_ACCESS_TOKEN and OpenCode vars in a .env file (do not commit it).
Examples
# Progress check for issue 123
node build/cli/index.js check-progress -i 123 -t $PAT
# Detect potential problems (bugbot) for issue 456 on current branch
node build/cli/index.js detect-potential-problems -i 456 -t $PAT
# Think / reasoning with a question
node build/cli/index.js think -q "Where is authentication validated?" -t $PAT
# Copilot (CLI-only, no workflow equivalent)
node build/cli/index.js copilot -p "Explain the main function" -t $PAT
For a step-by-step guide to testing the OpenCode Plan flows locally, see Testing OpenCode Plan Locally.