CLI Release Notes
The flik CLI lets you manage projects, view audit logs, and authenticate with your API key from the terminal. Run flik version open to open this page from the CLI.
Install
Build from source (requires Go):
cd cli && go build -o flik .
Set your API key (from flik.app/keys) via environment or a .flik file:
export FLIK_KEY=flik_xxx
export FLIK_API_URL=https://flik.app # or http://localhost:8080 for local
Changelog
Flik CLI Changelog
When you change the CLI, add an entry here (under Unreleased until you cut a release) and bump cmd/version.txt. The release notes page (/cli/releasenotes) renders this file.
Unreleased
- Shared pkg/flik: CLI now uses the shared
pkg/flikpackage for config (.flik + env) and all API calls. Enables the Flik MCP server to reuse the same logic (DNR). No change to CLI behavior or flags. - Project rules: Project name must be at least 4 characters. Acronym is the first 4 letters only (e.g. PROJ, MYPR); no numeric suffix. Returns conflict (409) if that acronym is already in use.
- (Add new changes here until next version bump.)
0.3.2 (2025-02-12)
- Defaults for Priority, Severity, Points: When adding a story or bug, defaults are applied when not provided: Priority
medium(both), Severitymedium(bug), Points0(story). New fieldpriorityon both types; optional--priorityon add/update.
0.3.1 (2025-02-12)
- Unified object commands: Get, update, and delete any issue (story or bug) by id:
flik get object POP-1,flik update object POP-1,flik delete object POP-1. Project from FLIK_PROJECT or--project. Update/delete accept the same flags as type-specific commands. - Web:
GET/PATCH/DELETE /api/cli/projects/:acronym/objects/:idfor get, update, delete by id (type-agnostic).
0.3.0 (2025-02-12)
- Stories and bugs: create, list, update, delete within a project. Shared model: id (e.g. POP-1), title, assigned_to (user_id), status; story: points, notes; bug: severity, description.
flik get stories [--project POP] [--assigned-to user_id]andflik get bugs [--project POP] [--assigned-to user_id].flik add story [title]andflik add bug [title]with optional--project,--assigned-to,--points/--notes(story),--severity/--description(bug).flik update story [id]andflik update bug [id]with optional--title,--assigned-to,--status, and type-specific flags.flik delete story [id]andflik delete bug [id]. Project from FLIK_PROJECT or--project.- Web:
/api/cli/projects/:acronym/storiesand/api/cli/projects/:acronym/bugs(GET list, POST create, GET/PATCH/DELETE by id). Deleting a project also deletes its issues.
0.2.1 (2025-02-12)
flik version openopens the release notes page in the browser.
0.2.0 (2025-02-12)
flik delete project [acronym]with acronym confirmation (destructive: deletes project and all records). Web: DELETE /api/cli/projects/:acronym.
0.1.9 (2025-02-12)
- Server-generated project acronyms (3 letters + 2-digit suffix, e.g. MYP01) to avoid conflicts.
0.1.8 (2025-02-12)
- FLIK_PROJECT interpreted as project acronym;
flik get logsfilters by acronym. API:project_acronymquery.
0.1.7 (2025-02-12)
.flikconfig file for FLIK_KEY, FLIK_API_URL, FLIK_PROJECT (env-style; env overrides). Search: cwd, parent dirs, then $HOME/.flik.
0.1.6 (2025-02-12)
flik get logsdefaults to today only;--allfor full history.
0.1.5 (2025-02-12)
- Audit log:
flik get logs [--project]; API records object_type, operation, user_id, timestamp.
0.1.4 (2025-02-12)
- Project acronym auto-generated from name (first 3 letters); optional
--acronymremoved.
0.1.3 (2025-02-12)
- Projects list returns id, acronym, name, created_at;
flik add projectwith optional--acronym.
0.1.2 (2025-02-12)
- Clearer JSON errors when API returns HTML;
flik get projectsreturns empty array when no projects.
0.1.1 (2025-02-12)
flik auth login [api-key]; GET /api/auth/validate; JSON output withcode(HTTP status).
0.1.0 (2025-02-11)
flik version(prints embedded version);flik upgrade(prints releases URL and Homebrew upgrade hint).- Fix
flick→fliktypos in auth commands.