For AI agents: the complete documentation index is available at https://docs.flezise.com/llms.txt, the full documentation bundle is available at https://docs.flezise.com/llms-full.txt, and this page is available as Markdown at https://docs.flezise.com/reference/swecli.md.
Docs

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.

Global flags

These flags apply to every command.

FlagPurpose
--project name|slug|uuidScope the command to one project. Without it, list commands use your workspace project when set, otherwise the platform scope.
--all-projectsCross-project listing where the verb supports it.
--format table|json|md|idsOutput format. Use json for fields the table omits.
--fields a,b,cChoose columns.
--limit N1-100.
--offset NPagination offset.
--workspaceWorkspace project.
--configConfig file path.

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]
FilterTypeValuesPurpose
kindenumartifact_approval|work_item_approval|assigned_work|decision|work_item_clarification|failed_run|interview_question|creation_approvalAction kind; separate multiple values with |
actionablebooltrue|falseFilter by actionable flag
sinceduratione.g. 7d, 24hItems updated within this window

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]
FilterTypePurpose
statusstringArtifact status, e.g. approved, draft
phasestringArtifact phase, e.g. planning, analysis
typestringArtifact type (client-side filter)
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]
FlagDefaultPurpose
--versionworkspaceVersion to fetch: workspace (what the UI shows), approved, or draft
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]
FlagDefaultPurpose
--comment(none)Approval comment
swecli artifact approve PRD-001 --comment "LGTM"

artifact reject

Reject an artifact and request changes.

swecli artifact reject <ref> [flags]
FlagDefaultPurpose
--comment(none)Rejection reason
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]
FlagDefaultPurpose
--title(required)Artifact title
--type(required)Artifact type, e.g. change-request, prd
--phase(required)Artifact phase, e.g. planning, analysis
--status(none)Initial status, e.g. draft, in_review
--content-file(none)Content file path; - reads stdin
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]
FlagDefaultPurpose
--title(required)Presentation title
--type(none)Artifact type
--phase(none)Artifact phase
--artifact(none)Display ID or UUID of the artifact to attach, e.g. PRD-001
--content-file(none)Content file path; - reads stdin
swecli artifact propose \
  --title "Revised PRD section" \
  --artifact PRD-001 \
  --content-file patch.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

Full-text search across platform documentation.

swecli docs search <query> [flags]
FlagDefaultPurpose
--k5Number of results; max 20
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]
FilterTypePurpose
phasestringFilter by current phase, e.g. planning, analysis
updateddurationProjects updated within this window, e.g. 7d
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]
FilterTypeValuesPurpose
statusenumpending|running|completed|failed|cancelledRun status
typestringe.g. generation, reviewRun type
swecli run list --project my-project status=failed
swecli run list --project my-project status=failed --limit 5

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]
FilterTypeValuesPurpose
stateenumintake_received|normalized|planning|awaiting_approval|awaiting_review|executing|needs_clarification|blocked|failed|completed|cancelled|rejected|duplicateWork item state
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