v0.1.7

Bug Fix

Fixed: Uploads command panic with -o flag (#5)

The -o short flag for uploads fetch conflicted with the global -o/--output flag added in v0.1.6, causing a clap type mismatch panic when AI agents tried to download attachments.

Breaking Change: The uploads output flag has been renamed:

• Old: linear-cli up fetch URL -o file.png
• New: linear-cli up fetch URL -f file.png

Changes

• Renamed -o/--output to -f/--file for the uploads fetch command
• Updated all documentation (CLAUDE.md, AGENTS.md, skills)

Full Changelog: v0.1.6...v0.1.7

Fixes #5

v0.1.6

Agent-Friendly CLI Improvements

This release focuses on making linear-cli more useful for AI coding assistants (Claude Code, Codex, Cursor, etc.).

New Global Flags

Flag	Purpose
--quiet / -q	Suppress decorative output (headers, tips, separators)
--id-only	Only output created/updated ID for command chaining

New Commands

• linear context / linear ctx - Detect current Linear issue from git branch name

  linear context              # Outputs: LIN-123
  linear ctx --output json    # Full issue details as JSON

Issue Command Improvements

• Batch fetching: linear i get LIN-1 LIN-2 LIN-3 fetches multiple issues in parallel
• Dry run: linear i create "Title" -t ENG --dry-run previews without creating
• Stdin support: cat desc.md | linear i create "Title" -t ENG -d -
• Piping: echo "LIN-123" | linear i get -

Structured Error Handling

• Exit codes: 0=success, 1=error, 2=not found, 3=auth error
• JSON errors: With --output json, errors return structured JSON:

  {"error": true, "message": "Issue not found", "code": 2}

Performance

• Sync command now runs local folder scan and API fetch in parallel
• Projects added to cache system for faster subsequent calls

Documentation

• Updated CLAUDE.md with agent-friendly examples
• Updated AGENTS.md for OpenAI Codex compatibility
• Updated linear-issues skill documentation

Full Changelog: v0.1.5...v0.1.6

v0.1.5

What's New

Bug Fixes

• Delete command: Now prompts for confirmation instead of silently doing nothing without --force
• Sync command: Uses cross-platform ~/code default instead of hardcoded Windows path

Improvements

• Interactive update mode: Added Status, Assignee, and Description options
• Code cleanup: Removed dead code, zero compiler warnings
• Tests: Added 6 new unit tests for branch name generation

Full Changelog

• Fix delete command confirmation prompt
• Fix cross-platform default directory for sync
• Remove unused workspace.rs and cache.rs methods
• Expand interactive update with status/assignee/description
• Add unit tests for git branch name generation

v0.1.4 - JSON Output for Comments

New Feature

JSON Output for Comments List

Now supports --output json for comments, saving tokens for LLM/AI agent usage:

linear-cli cm list ISSUE_ID --output json
linear-cli comments list ISSUE_ID -o json

Returns full comment data as JSON instead of truncated ASCII table - much more useful for AI coding assistants!

Closes #4

v0.1.3 - Uploads Command & AI Agent Docs

New Features

Uploads Fetch Command

Download attachments and images from Linear with API key authentication:

linear-cli up fetch "https://uploads.linear.app/..." -o image.png
linear-cli up fetch URL | base64  # Pipe to other tools

AI Agent Integration Docs

Ready-to-copy snippets for:

• Claude Code (CLAUDE.md)
• Cursor (.cursorrules)
• Generic agent instructions

Includes token efficiency comparison - CLI uses 10-50x fewer tokens than MCP tools!

LINEAR_API_KEY Environment Variable

Set API key via environment variable instead of config file:

export LINEAR_API_KEY=lin_api_xxx
linear-cli issues list

Fixes

• Improved error handling for upload fetches (401/403/404 messages)

---

Thanks to the community for feature suggestions! 🎉

v0.1.2

What's New

Environment Variable Support for API Key

You can now override the configured API key using the LINEAR_API_KEY environment variable. This enables:

• CI/CD pipelines - Set API key via environment without modifying config files
• Multi-workspace scripts - Run commands against different workspaces without switching
• Agent processes - Spawn isolated processes with their own API key context
• Security - Avoid storing API keys in config files on shared systems

# Override API key for a single command
LINEAR_API_KEY=lin_api_xxx linear-cli issues list

# Set for entire shell session
export LINEAR_API_KEY=lin_api_xxx

Contributors

Thanks to @mberg for contributing this feature!

v0.1.1

Full Changelog: v0.1.0...v0.1.1

v0.1.0

Full Changelog: https://github.com/Finesssee/linear-cli/commits/v0.1.0