Fizzy CLI #2358

jeremy · 2026-01-13T18:12:28Z

Introduces fizzy, an agent-first CLI for Fizzy.

Fizzy CLI

Foundation: Entry point, config management, API client, OAuth auth flow
Queries: boards, cards, columns, people, tags, search, notifications, show
Actions: card create, close, reopen, triage, postpone, comment, assign, tag, watch, gild, step
Ergonomics: Name resolution, --in alias, multi-origin credential storage, pagination
Distribution: Install script, bash/zsh completions, README

Design Highlights

Agent-first: JSON envelopes with breadcrumbs, predictable patterns
Human-friendly: Markdown output in TTY, rich help text
Dependencies: Bash 4+, curl, jq
Builds on Minimal modern OAuth 2.1 stack #2296 for seamless auth

Test plan

All 256 bats tests pass (bats test/*.bats)
Smoke tested against http://fizzy.localhost:3006
OAuth flow works (browser and --no-browser modes)
Name resolution works across paginated endpoints
Card create chains follow-up actions (triage, tag, assign)

It sends all buttons in one connect payload.

…page controller.

* main: (65 commits) Repair scope for card styles within the columns view Add missing list to cards page Account for simpler public views Fix public layout Pull board-tools outside of the list for mobile saas: move log_level setting into an environment variable Restore log level configurability in production environment Remove engagements Use notch class so Save button is positioned correctly Go back to board after clearing filters Revert "Use existing no_filtering_url to direct back to the board when clearing filters" Use existing no_filtering_url to direct back to the board when clearing filters Ensure filters sit on top of cards Fix public boards Fix card grid layout Fix Chinese/Japanese characters missing from printed PDFs on macOS Add SQLite FTS5 support for CJK search Add CJK (Chinese, Japanese, Korean) search support Fix scrolling on mobile Remember expanded state on navigation ...

@uri

api_get_all: - Fall back to ?page=N when Link headers absent - Stop on empty response to prevent infinite loops urlencode: - Replace python3 urllib.parse with jq -sRr @uri - Removes undocumented Python dependency

Completions: - Zsh: use \$words[1] in args state (array is shifted) - Remove --page from global flags (it's per-command) cards: - Add postponing_soon to --status filter help + completion

- Global flags (--json, --quiet) must precede command name - Default base URL is local dev, not production - Add pagination note for cards command

Adds --all/-a flag to boards, tags, people, and notifications commands to fetch all pages automatically using api_get_all. When --all is used: - Summary shows "(all)" instead of page number - "Next page" breadcrumb is omitted This matches the Go CLI's full-fetch behavior while maintaining the per-page --page flag for incremental fetching. Smoke test notes: - fizzy boards --all returns all boards (verified with 3 boards) - fizzy tags --all returns all tags - fizzy people --all returns all users - fizzy notifications --all returns all notifications

Adds `fizzy update <number> [options]` to update a card's title or description. Uses PATCH /cards/{number} endpoint. Options: - --title, -t: New card title - --description, -d: New card description (HTML) - --description-file: Read description from file This brings parity with the Go CLI's card update functionality. Smoke test notes: - fizzy update 1 --title "New title" updates title - fizzy update 1 --description "content" updates description - fizzy update 1 --title "A" --description "B" updates both - fizzy update 1 --description-file notes.html works - Error if no options provided (nothing to update)

Changed from standalone commands (fizzy edit-comment, fizzy delete-comment) to subcommands of comment (fizzy comment edit, fizzy comment delete). Usage: fizzy comment "text" --on <num> # Create comment (unchanged) fizzy comment edit <id> --on <num> "new text" # Update comment fizzy comment delete <id> --on <num> # Delete comment API: PATCH/DELETE /cards/:num/comments/:id Smoke test: fizzy comment edit --help; fizzy comment delete --help

fizzy delete <number> [numbers...] Permanently deletes cards. Shows warning in help that action cannot be undone. API: DELETE /cards/:number (returns 204 No Content) Smoke test: fizzy delete --help

fizzy delete-image <number> removes the header image from a card. Uses DELETE /cards/:number/image (returns 204), then fetches the card to show updated state.

Card update: wrap params in {card: {...}} as Rails expects params[:card] Comment edit: Rails returns 204 No Content on PATCH, so fetch the updated comment after to get its current state for display.

Steps: - Add --completed flag to step create - Add step show/update/delete subcommands - Fix body wrapper to {step: {...}} as Rails expects Reactions: - Add fizzy reactions --card <num> --comment <id> to list reactions - Add fizzy react delete <id> --card <num> --comment <id> - Update fizzy react to manage reactions (add + delete) All commands follow existing subcommand patterns (like comment edit/delete). Shell completions updated for new subcommands.

Identity & Users: - fizzy identity: show current user and accounts - fizzy user show/update/delete: manage users - User avatar upload via multipart form Card Images: - --image flag on card create and card update - Multipart upload with retry/backoff for 429/5xx - Use --form-string for non-file fields (prevents @-prefix hazard) Auth & Config: - FIZZY_URL convenience var (extracts base URL + account slug) - Allow re-login without logout - Improved token and scope handling Reliability: - api_multipart_request helper with retry logic - Regression test for --form-string usage 387 tests passing, smoke tested against live server.

Adds Jbuilder views for index, show, and create actions.

Internal endpoints (Tier 3) - functional but intentionally undocumented.

- Fix card create/update params (remove status, tag_ids) - Fix card move request shape (top-level board_id) - Fix board update request (top-level user_ids) - Fix comment update response (204 No Content) - Fix column reordering paths (shallow routes) - Add 429 to error codes table - Add endpoint-specific error table - Add API docs maintenance micro-skill - Align webhook actions with PERMITTED_ACTIONS

Documents API↔CLI coverage and intentional omissions (pins, involvement).

- fizzy webhooks: list webhooks - fizzy webhook create/show/update/delete - Align available actions with Webhook::PERMITTED_ACTIONS - Add assert_json_contains test helper - Add 17 webhook tests including action list lock tests

- fizzy account show/update/entropy/join-code/export - Export accepts HTTP 202 for async operations

- fizzy --version / -V / version: show installed version - fizzy self-update: update CLI from GitHub - fizzy self-update --check: check without installing - Add VERSION file for semver tracking - Add 9 tests for version and self-update

- fizzy board publish: publish board publicly with shareable URL - fizzy board unpublish: remove public access - fizzy board entropy: set auto-postpone period - Use publish response URL correctly

- fizzy user role: change user role (owner/admin/member)

- fizzy card publish: publish draft card - fizzy card move --to: move card to different board

- Add webhooks, account to help topics - Update command listings for new subcommands

- Fix unbound variable EXIT_API_ERROR (was EXIT_API) - Guard against self-update in git checkouts (suggest git pull) - Guard against non-writable FIZZY_ROOT (suggest brew upgrade) - Add tests for git checkout detection

Version tracking changes: - Remove VERSION file (no manual version bumping) - Install script fetches latest commit SHA from GitHub API - Write commit SHA to .commit file during install - Display version as "fizzy main (abc1234)" format - self-update compares commits instead of version strings Uninstall command: - fizzy uninstall shows what will be removed - fizzy uninstall --force removes installation and symlinks - Guards for git checkout and Homebrew installs - Removes symlink from common bin directories

Install script improvements: - Support FIZZY_REPO, FIZZY_REF, FIZZY_COMMIT env vars for forks/CI - Try branch then tag when downloading (supports both refs/heads and refs/tags) - Gracefully handle GitHub API rate limits (commit SHA is best-effort) - Add 5s timeout to API calls to avoid hanging Self-update improvements: - --force now works even when GitHub API is unavailable - Better error messages suggesting --force when rate-limited - Re-try commit SHA fetch after download in _perform_update - Fall back to branch name in .commit if SHA unavailable - Use FIZZY_BRANCH in status messages instead of hardcoded "main"

svara and others added 30 commits January 6, 2026 15:46

Add Hotwire Native Bridge wiring.

b84da94

Add bridge page controller and helpers.

177afe1

Add bridge page targets.

ecf0921

Add hotwire-native-bridge vendor js.

37f0a2c

Fix bridge viewport safe-area insets.

2d7b76f

Use raw page_title in bridge page title attribute

367a7ab

Add bridge insets controller.

69c17a7

Wire bridge insets controller into the layout.

cdc4f2c

Add bridge nav-button controller.

367edfc

Add bridge form controller.

c61942d

Hide bridged submit button when native form component is active.

4cbc2c6

Add bridged_form_with helper for bridge form controller.

58664f8

Use bridged_form_with for board creation form.

de10717

Move bridge insets controller to bridge/controllers.

ce0538d

Hide bridged nav-button elements when native nav component is active.

75431e0

Use bridge nav-button for board settings action.

dc9c544

Add bridge buttons controller.

76eaf32

It sends all buttons in one connect payload.

Remove bridge nav-button controller.

9331c37

Remove form related events from bridge page controller.

e2f9989

Remove option to toggle header visibility from mobile apps in bridge …

b8bb4cf

…page controller.

Use bridge buttons controller in boards.

37f03fc

Remove redundant url from bridge page change payload.

0a57e39

Add bridge overflow menu controller.

d38c0c9

Hide bridged overflow-menu elements when native is active.

1a46ed3

Update overflow menu controller to send an array of menu items.

674509b

Move bridge javascript into existing folder structure

3a43941

Move bridge buttons controller to <body>

45f24d9

Remove useless shouldLoad

1028eab

Use hidden overflow menu container for board bridge items.

0d21efc

jeremy added 28 commits January 21, 2026 23:55

Add pagination fallback + remove Python dependency

2792c91

api_get_all: - Fall back to ?page=N when Link headers absent - Stop on empty response to prevent infinite loops urlencode: - Replace python3 urllib.parse with jq -sRr @uri - Removes undocumented Python dependency

Fix completions and add postponing_soon status

3e44c05

Completions: - Zsh: use \$words[1] in args state (array is shifted) - Remove --page from global flags (it's per-command) cards: - Add postponing_soon to --status filter help + completion

Update README for global flags and local dev default

c4d4b7b

- Global flags (--json, --quiet) must precede command name - Default base URL is local dev, not production - Add pagination note for cards command

Document env var auth path in help and status

098bf66

Add card delete command

a0a84af

fizzy delete <number> [numbers...] Permanently deletes cards. Shows warning in help that action cannot be undone. API: DELETE /cards/:number (returns 204 No Content) Smoke test: fizzy delete --help

Add card image delete command

41bc591

fizzy delete-image <number> removes the header image from a card. Uses DELETE /cards/:number/image (returns 204), then fetches the card to show updated state.

Fix API request/response handling

8f2a56a

Card update: wrap params in {card: {...}} as Rails expects params[:card] Comment edit: Rails returns 204 No Content on PATCH, so fetch the updated comment after to get its current state for display.

Add JSON responders for webhooks controller

6891939

Adds Jbuilder views for index, show, and create actions.

Add JSON responders for pins, involvements, publications

0e669f0

Internal endpoints (Tier 3) - functional but intentionally undocumented.

Add JSON responders for account, board, column, and role endpoints

07b5d75

Add CLI parity matrix

2813500

Documents API↔CLI coverage and intentional omissions (pins, involvement).

Add webhook CLI commands

0bc7971

- fizzy webhooks: list webhooks - fizzy webhook create/show/update/delete - Align available actions with Webhook::PERMITTED_ACTIONS - Add assert_json_contains test helper - Add 17 webhook tests including action list lock tests

Add account CLI commands

a047efe

- fizzy account show/update/entropy/join-code/export - Export accepts HTTP 202 for async operations

Add self-update command and version tracking

f69ff6e

- fizzy --version / -V / version: show installed version - fizzy self-update: update CLI from GitHub - fizzy self-update --check: check without installing - Add VERSION file for semver tracking - Add 9 tests for version and self-update

Add board publish, unpublish, and entropy commands

d65f73c

- fizzy board publish: publish board publicly with shareable URL - fizzy board unpublish: remove public access - fizzy board entropy: set auto-postpone period - Use publish response URL correctly

Add user role command

fd2b67a

- fizzy user role: change user role (owner/admin/member)

Add card publish and move commands

1d8d599

- fizzy card publish: publish draft card - fizzy card move --to: move card to different board

Update help and API client for new commands

fe48ea2

- Add webhooks, account to help topics - Update command listings for new subcommands

Update CLI plan with complete command reference

04e7999

Fix self-update: EXIT_API_ERROR → EXIT_API, add safety guards

e71ea1f

- Fix unbound variable EXIT_API_ERROR (was EXIT_API) - Guard against self-update in git checkouts (suggest git pull) - Guard against non-writable FIZZY_ROOT (suggest brew upgrade) - Add tests for git checkout detection

jeremy force-pushed the cli branch from 2dff42e to 7b3195f Compare January 22, 2026 07:55

jeremy mentioned this pull request Jan 23, 2026

Minimal MCP server for AI agent integration #2298

Open

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Fizzy CLI #2358

Fizzy CLI #2358

Uh oh!

jeremy commented Jan 13, 2026 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

9 participants

Fizzy CLI #2358

Are you sure you want to change the base?

Fizzy CLI #2358

Uh oh!

Conversation

jeremy commented Jan 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Fizzy CLI

Design Highlights

Test plan

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

9 participants

jeremy commented Jan 13, 2026 •

edited

Loading