AI-powered workflow automation in your terminal.
# Homebrew (macOS and Linux)
brew install fiestatools/tap/workflowfiesta
# Direct download (macOS, Linux, Windows)
# Download from https://github.com/fiestatools/workflowfiesta-cli/releases# Start the CLI
wf
# Or use the full name
workflowfiestaOn first run, you'll be prompted to authenticate with your API token.
Press / to open the command palette:
| Command | Description |
|---|---|
/new |
Start a new conversation |
/agent |
Switch to a different agent |
/rename <new title> |
Rename the current conversation |
/history |
Browse past conversations |
/settings |
Open settings panel |
/copy |
Copy the last reply |
/help |
Show help and shortcuts |
Run /agent to switch agents for the current conversation. The picker shows your org's available agents with descriptions.
Run /settings (or Ctrl+S) to open the settings panel. It shows:
- Account — who you're signed in as, your organization, and the access token in use with its expiry
- Configuration — API base URL and request timeout
- Default agent — the agent new conversations start with. Choose a specific agent to pin it for this CLI, or "Use account default" to follow whatever your account sets in the web app. This is separate from
/agent, which only switches the current conversation.
Run /history to browse and manage previous conversations. Conversations are stored locally and synced with the backend.
| Key | Action |
|---|---|
Enter |
Reopen the selected conversation |
r |
Rename the selected conversation |
Space |
Mark/unmark for bulk delete |
d |
Delete the selected (or marked) conversations, with confirmation |
The CLI handles mid-run agent requests inline:
- Credentials - Secure form for entering secrets
- OAuth - Browser-based authorization flow
- MCP servers - Server configuration and connection
Verdicts from the platform's guard agents render as distinct bubbles, matching the web app:
- Auth Cop - Security reviews with their decision (approved / awaiting confirmation / declined)
- Secret Safe - Redaction notices when secrets are detected
- Helping Hand - Suggestions when a run needs a nudge
| Shortcut | Action |
|---|---|
/ |
Open command palette |
Ctrl+B |
Toggle side panel |
Ctrl+S |
Toggle settings |
Ctrl+N |
New conversation |
Shift+Enter |
Newline in input |
Enter |
Send message |
Ctrl+C |
Quit |
Config files are stored in ~/.config/workflowfiesta/cli/:
| File | Purpose |
|---|---|
config.json |
User preferences |
credentials.json |
Auth token and API URL |
conversations.json |
Local conversation index |
# Install dependencies
bun install
# Run in dev mode
bun dev
# Build all platforms
bun run buildWorkflowFiesta | Website | Documentation