linctl v0.1.8

Summary

• update Personal API key guidance to Linear's current Security & Access URL
• keep README, auth prompt, and test env example aligned

Verification

• go test ./...
• go build
• linctl --version
• linctl --help

Notes

• smoke_test.sh was not run because it requires an authenticated Linear session in the local environment

linctl v0.1.7

What's New

Issue Relation Commands (contributed by @OfriHarlev)

New linctl issue relation subcommands for managing issue relations directly from the CLI:

linctl issue relation list LIN-123
linctl issue relation add LIN-123 --blocks LIN-456
linctl issue relation add LIN-123 --blocked-by LIN-456
linctl issue relation add LIN-123 --related LIN-456
linctl issue relation add LIN-123 --duplicate LIN-456
linctl issue relation add LIN-123 --similar LIN-456
linctl issue relation remove RELATION-ID

Improvements

• Direction-aware relation labels (blocks vs blocked by displayed correctly)
• Consistent JSON output shape for both forward and inverse relations
• Added --similar relation type (matching the full Linear API enum)
• Smoke tests and unit tests for all relation commands
• README updated with relation command docs

linctl v0.1.6

Highlights

• Breaking CLI rename for team workflow commands:
  • linctl team statuses -> linctl team state list
  • linctl team status-update -> linctl team state update
• Added --state / -s to linctl issue create to create directly into a workflow state.
• Added command tests covering:
  • team state list
  • issue create --state state resolution
• Updated docs/examples (README.md, SKILL.md) to match current CLI command surface.

Upgrade Notes

• If you used the old team status commands, switch scripts to linctl team state list and linctl team state update.

linctl v0.1.5

Highlights:

• Add linctl graphql command for raw Linear API operations
• Reuse existing linctl auth for GraphQL escape-hatch workflows
• Support query input via positional arg, --query, --file, or stdin piping
• Support variables via --variables and --variables-file
• Add tests and docs updates for graphql command

linctl v0.1.4

Highlights:

• Add team workflow status commands: team statuses and team status-update
• Add API support for workflowStateUpdate mutation
• Add tests for team state APIs and command wiring
• Skill/docs cleanup and dev version bump

linctl v0.1.3

Highlights\n- Add linctl label create --is-group to create group labels\n- Add command/API test coverage for is-group label creation\n- Document new flag in README

linctl v0.1.2

linctl v0.1.2

This release captures all major improvements since v0.1.0 (including and beyond v0.1.1).

Highlights Since v0.1.0

• Expanded issue management capabilities:

  • issue search support
  • cycle display and filtering (--cycle current, --cycle <number>)
  • issue attachments (issue attach) for GitHub PRs and URLs
  • project + project milestone assignment/linking
  • parent issue updates
  • delegate support on create/update (--delegate)
  • label assignment and clearing (--labels, --clear-labels)

• New top-level command areas:

  • label command with full CRUD
  • agent command:
    • linctl agent <issue-id> for session/delegation status
    • linctl agent mention <issue-id> <message...>

• Full comment lifecycle support:

  • comment get, comment update, comment delete
  • improved comment listing output (IDs included for update/delete flows)

• Broader CLI coverage and project operations:

  • project CRUD improvements (create/update/delete/archive)
  • team/user command expansion and data surface improvements

• Auth and configuration improvements:

  • LINCTL_API_KEY environment override support
  • stronger auth/docs guidance

• Output and rendering improvements:

  • safer handling of system comments / missing actors
  • richer plaintext/table/JSON consistency across commands

• Reliability and testing:

  • smoke testing introduced and evolved
  • additional API tests for comment CRUD, label CRUD, and agent/delegate support

• Release and distribution improvements:

  • Homebrew tap bump automation workflow
  • improved release checklist and contributing docs

Notes

• If Homebrew still shows older command surface after upgrading, run:
  • brew update && brew upgrade linctl
  • brew reinstall linctl

Thanks to everyone who contributed ideas, PRs, and testing feedback.

linctl v0.1.1

Highlights:

• New subcommands: project, team, user, comment, docs
• Issue list: sorting (linear/created/updated), include completed, time filtering (e.g. 2_weeks_ago, all_time)
• Richer issue/project outputs: sub-issues, branches, cycle, project, attachments, comments
• Utilities: time parsing, smoke tests, improved README
• Fixes: state name validation; attachment unmarshalling

Install:

• Homebrew: brew tap dorkitude/linctl && brew install linctl
• From source: make deps && make build && sudo mv linctl /usr/local/bin/

linctl v0.1.0 - Initial Release

🎉 linctl v0.1.0 - Initial Release

We're excited to announce the first release of linctl - a comprehensive command-line interface for Linear's API!

✨ Features

🔐 Authentication

• Personal API Key support
• OAuth 2.0 support
• Secure credential storage
• Authentication status checking

📋 Issue Management

• Create, list, update, and archive issues
• Filter by assignee, state, project, and more
• Full issue details with comments and attachments
• Bulk operations support

👥 Team & User Management

• List and view teams
• Team member management
• User profiles and permissions

🚀 Project Tracking

• Create and manage projects
• Project milestones and progress tracking
• Project-based issue filtering

💬 Collaboration

• Add and view issue comments
• File attachments support
• Webhook configuration and management

🎨 Output Formats

• Beautiful table output (default)
• Plain text for non-interactive environments
• JSON for scripting and automation

🛠️ Installation

From Source

git clone https://github.com/dorkitude/linctl.git
cd linctl
go build -o linctl
sudo mv linctl /usr/local/bin/

🚀 Quick Start

# Authenticate with Linear
linctl auth

# Check your authentication
linctl whoami

# List your assigned issues
linctl issue list --assignee me

# Create a new issue
linctl issue create --title "My first issue" --team ENG

📖 Documentation

For full documentation and examples, visit the linctl repository.

🙏 Acknowledgments

Built with ❤️ using:

• Cobra for CLI framework
• Viper for configuration
• Linear's GraphQL API

---

Full Changelog: https://github.com/dorkitude/linctl/commits/v0.1.0