CLI reference

Specification - implementation in progress. The commands below reflect the specified Flexor CLI interface. Commands marked (preview) are specified but not yet fully implemented in all environments.

Global flags

Flag	Description
--env <environment>	Target environment: sandbox, staging, or production. Defaults to sandbox.
--vault <name>	Scope command to a specific vault. Defaults to the vault in the current directory.
--output <format>	Output format: text (default), json, csv.
--quiet	Suppress non-error output.
--debug	Enable verbose debug output.

---

flexor init

Initialize a new Flexor project in the current directory.

flexor init [--name <project-name>] [--tier <L2|L3|L4>]

Creates vault.json, directory structure, and a .gitignore that excludes .flexor/ and credential files.

---

flexor auth

Manage authentication.

flexor auth login [--sandbox]
flexor auth logout
flexor auth status
flexor auth token   # Print the current session token

---

flexor validate

Validate vault configuration, skill YAML, and agent YAML.

flexor validate [--agent <name>] [--skill <name>] [--strict]

Flag	Description
--agent <name>	Validate a specific agent only.
--skill <name>	Validate a specific skill only.
--strict	Treat warnings as errors.

---

flexor sync

Sync vault source to the Flexor runtime.

flexor sync [--vault <name>] [--dry-run] [--force] [--strategy <accept-remote|accept-local|manual>]

---

flexor deploy

Deploy agents and skills to the target environment.

flexor deploy [--agent <name>] [--skill <name>] [--env <environment>] [--dry-run]

---

flexor agents

Manage agents.

flexor agents list [--env <environment>] [--status <active|paused|erroring>]
flexor agents get <name> [--env <environment>]
flexor agents pause <name> [--env <environment>]
flexor agents unpause <name> [--env <environment>]
flexor agents kill --run <run_id>

---

flexor run

Manually trigger an agent run.

flexor run <agent-name> [--now] [--env <environment>] [--event <json>] [--debug]

Flag	Description
--now	Run immediately, ignoring the trigger schedule.
--event <json>	JSON payload to pass as the trigger event.
--debug	Print step-by-step execution details.

---

flexor logs

View agent run logs.

flexor logs [--agent <name>] [--run <run_id>] [--env <environment>]
            [--tail] [--limit <n>] [--status <success|partial|failed>] [--verbose]

Flag	Description
--tail	Stream new log entries in real time.
--verbose	Include step inputs, outputs, and condition evaluations.

---

flexor audit

Query the audit log.

flexor audit [--agent <name>] [--from <date>] [--to <date>]
             [--status <success|partial|failed>] [--limit <n>] [--format <text|json|csv>]

---

flexor skills

Manage skills.

flexor skills list [--tag <tag>] [--vault <name>]
flexor skills get <name>
flexor skills test <name> --input <json>    # (preview)

---

flexor status

Show environment health.

flexor status [--env <environment>]

---

flexor rollback

Roll back an agent to a previous deployed version.

flexor rollback --agent <name> [--version <semver>] [--env <environment>]

---

flexor connections

Manage data source connections.

flexor connections list [--env <environment>]
flexor connections test --source <name> [--env <environment>]

---

flexor access

Manage RBAC assignments.

flexor access list [--vault <name>]
flexor access grant --user <email> --role <viewer|operator|admin|owner> [--vault <name>]
flexor access revoke --user <email> [--vault <name>]

---

flexor support

Generate a support bundle for escalation.

flexor support bundle [--run <run_id>] [--agent <name>]

Produces a sanitized bundle file. Credentials and PII are excluded. Share the file or its bundle ID with your PLEXI technical contact.

---

flexor archive

Archive a vault (removes it from the active runtime, retains for audit).

flexor archive --vault <name> [--env <environment>]