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/flik package 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), Severity medium (bug), Points 0 (story). New field priority on both types; optional --priority on 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/:id for 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] and flik get bugs [--project POP] [--assigned-to user_id].
  • flik add story [title] and flik add bug [title] with optional --project, --assigned-to, --points/--notes (story), --severity/--description (bug).
  • flik update story [id] and flik update bug [id] with optional --title, --assigned-to, --status, and type-specific flags.
  • flik delete story [id] and flik delete bug [id]. Project from FLIK_PROJECT or --project.
  • Web: /api/cli/projects/:acronym/stories and /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 open opens 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 logs filters by acronym. API: project_acronym query.

0.1.7 (2025-02-12)

  • .flik config 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 logs defaults to today only; --all for 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 --acronym removed.

0.1.3 (2025-02-12)

  • Projects list returns id, acronym, name, created_at; flik add project with optional --acronym.

0.1.2 (2025-02-12)

  • Clearer JSON errors when API returns HTML; flik get projects returns empty array when no projects.

0.1.1 (2025-02-12)

  • flik auth login [api-key]; GET /api/auth/validate; JSON output with code (HTTP status).

0.1.0 (2025-02-11)

  • flik version (prints embedded version); flik upgrade (prints releases URL and Homebrew upgrade hint).
  • Fix flickflik typos in auth commands.