Fishladder CLI

Command-line tool for Fishladder — manage projects, tasks, feedback, hiring, and AI features from your terminal.

npm install -g fishladder

Authentication

fish login          # Opens browser for OAuth login
fish logout         # Remove stored token
fish whoami         # Show current user

Or set FISHLADDER_API_KEY=fl_<key> to skip browser login (useful for CI).

Commands

Projects & Roadmap

fish projects list
fish goals list
fish goals create "Reduce churn by 20%"
fish initiatives list
fish initiatives create "Platform v2" --status in_progress
fish rows list
fish rows create "Growth"

Tasks

fish tasks list --project <id>
fish tasks create "Fix auth bug" --project <id> --priority high --due 2026-04-01
fish tasks update <id> --status in_progress --assign <userId>
fish tasks complete <id>

Smart syntax for quick task creation:

fish tasks create "Fix login bug" --project <id> @sarah !high #backend due:friday

• @user — assignee
• !priority — low, medium, high, urgent
• #tag — tags (multiple allowed)
• due:date — YYYY-MM-DD, today, tomorrow, or weekday name

Feedback

fish feedback list
fish feedback create "Users want dark mode" --impact high --company "Acme Corp"
fish feedback analyze --ids fb1,fb2,fb3

Analyze also supports stdin:

fish feedback list --format json | fish feedback analyze
echo "Users keep asking for dark mode" | fish feedback analyze

Hiring

fish hiring jobs
fish hiring candidates
fish hiring pipeline --job <id>
fish hiring move <applicationId> --stage <stageId>
fish hiring hire <applicationId>
fish hiring reject <applicationId> --reason "Not a fit"

AI

# Chat with the AI assistant
fish ai chat "what's blocking the platform team?"

# Generate tasks from meeting notes
cat meeting-notes.txt | fish ai generate-tasks --project <id>
pbpaste | fish ai generate-tasks --project <id>

# Feedback intelligence
cat support-transcript.txt | fish ai ingest --source support
fish ai auto-group
fish ai suggest-projects

# Task suggestions
fish ai suggest-priority <taskId>
fish ai suggest-assignment <taskId>
fish ai detect-blocked --project <id>

# Hiring AI
fish ai score <applicationId>
fish ai bottlenecks --job <id>

# Roadmap AI
fish ai connect-goals

# Signals & actions
fish ai signals --module feedback
fish ai actions --status pending
fish ai approve <actionId>
fish ai reject <actionId>
fish ai undo <actionId> --feedback "Wrong priority"

Other

fish custom-fields list --type task
fish webhooks list
fish webhooks create https://example.com/hook --events task.created,task.updated

JSON Output

Every list command supports --format json for scripting:

fish tasks list --project <id> --format json | jq '.[].title'
fish feedback list --format json | jq 'length'

Environment Variables

| Variable | Default | Purpose | |----------|---------|---------| | FISHLADDER_API_KEY | — | API key (skips browser login) | | FISHLADDER_API_URL | https://app.ladder.fish/api/v1 | API base URL | | FISHLADDER_AUTH_URL | https://app.ladder.fish | Auth page URL |

Development

git clone https://github.com/prone/fishladder-cli.git
cd fishladder-cli
npm install
npm link
npm test        # 83 tests

License

MIT