#swecli reference

swecli is the command-line interface to Flezise. It runs as the signed-in user, inside an agent's sandbox or on your machine, and every write it makes is audited. The code-intelligence, context, and evidence commands live in the separate swecli platform group; see swecli platform.

#Global flags

These flags apply to every command.

Filters accept either positional form (status=in_review) or flag form (--status in_review).

#action list

List pending actions for the current user.

swecli action list [field=value …] [flags]

Default columns: id, kind, title, actionable, url. blocking_reason is available but not shown by default.

# Pending decisions and failed runs in the last week
swecli action list kind=failed_run|decision since=7d

# Include blocking_reason across all projects
swecli action list --all-projects --fields id,kind,title,actionable,blocking_reason

#artifact list

List artifacts in the current project.

swecli artifact list [field=value …] [flags]

swecli artifact list status=approved phase=planning
swecli artifact list status=draft --format json

#artifact get

Get an artifact by ID or display ID.

swecli artifact get <ref> [flags]

swecli artifact get PRD-001
swecli artifact get PRD-001 --version approved

#artifact review

Show the workspace version, recent versions, and open comments for an artifact.

swecli artifact review <ref>

swecli artifact review PRD-001

#artifact approve

Approve an artifact at your current approval level.

swecli artifact approve <ref> [flags]

swecli artifact approve PRD-001 --comment "LGTM"

#artifact reject

Reject an artifact and request changes.

swecli artifact reject <ref> [flags]

swecli artifact reject PRD-001 --comment "Needs revision"

#artifact create

Create a new artifact directly in the project. Requires --title, --type, and --phase.

swecli artifact create --title <title> --type <type> --phase <phase> [flags]

swecli artifact create \
  --title "QA smoke change request" \
  --type change-request \
  --phase analysis \
  --content-file draft.md

# Read content from stdin
cat draft.md | swecli artifact create --title "Draft PRD" --type prd --phase analysis --content-file -

#artifact propose

Stage content for a person to accept or reject in the UI. Use this when an artifact already exists; it does not create a new document.

swecli artifact propose --title <title> [flags]

swecli artifact propose \
  --title "Revised PRD section" \
  --artifact PRD-001 \
  --content-file patch.md

#capabilities

Print what swecli can do in the current context: the scope (project when a project is resolved from SWE_PROJECT_ID or the workspace config, otherwise platform), the project ID, whether platform documentation is reachable, and every registered resource command with its summary.

swecli capabilities [--md]

swecli capabilities
swecli capabilities --md

For the full generated command reference, run swecli help --md.

#docs list

List available platform documentation pages.

swecli docs list [flags]

swecli docs list
swecli docs list --format json

#docs read

Fetch a documentation page. Append #heading to retrieve a single section.

swecli docs read <path>[#heading]

swecli docs read platform/cli.md
swecli docs read platform/ui-guide.md#approve-an-artifact

#docs search

Full-text search across platform documentation.

swecli docs search <query> [flags]

swecli docs search "pending actions"
swecli docs search "approval" --k 10

#me

Show your profile, accessible projects, and pending action counts.

swecli me [flags]

swecli me
swecli me --format json

#project list

List accessible projects.

swecli project list [field=value …] [flags]

swecli project list
swecli project list phase=analysis
swecli project list updated=7d

#project get

Get a project by ID or slug.

swecli project get <ref>

swecli project get my-project-slug

#project status

Show the current lifecycle and phase status for a project.

swecli project status [--project <ref>]

swecli project status --project my-project-slug

#run list

List workflow runs in the current project. Requires --project or SWE_PROJECT_ID.

swecli run list [field=value …] --project <ref> [flags]

swecli run list --project my-project status=failed
swecli run list --project my-project status=failed --limit 5

#tdd

Run one phase of the red-green TDD evidence protocol against a workspace. The red phase runs the workspace's test command and confirms a genuine failing test exists; the green phase re-runs it and confirms every previously failing test now passes. The test command comes from the first test-category check in .sdlc/verify.yaml, falling back to an ecosystem default detected from the workspace.

swecli tdd --phase red [--workspace DIR]
swecli tdd --phase green --evidence FILE [--workspace DIR]

Each phase prints a JSON result with a status field: red_confirmed, red_missing, or no_test_command for red; green_confirmed or still_red for green. Every protocol outcome exits 0; exit 1 means the runner itself malfunctioned (status error). Feed the red result to the green phase unchanged.

# Confirm the failing test, then verify the fix
swecli tdd --phase red > red.json
swecli tdd --phase green --evidence red.json

# Pipe the evidence instead of writing a file
swecli tdd --phase red | swecli tdd --phase green --evidence -

#work-item list

List work items in the current project. Requires --project or SWE_PROJECT_ID.

swecli work-item list [field=value …] --project <ref> [flags]

swecli work-item list --project my-project state=awaiting_approval
swecli work-item list --project my-project state=failed

#work-item get

Get a work item by ID or display ID.

swecli work-item get <ref> [--project <ref>]

swecli work-item get WI-42 --project my-project