{"name":"linctl: A Powerful CLI Tool for Linear API Management","description":"linctl is a robust command-line interface designed for managing Linear's API, catering to both automated agents and human users. Built in Go with Cobra, it offers extensive features for issue, project, and team management. This tool streamlines Linear workflows, providing flexible output formats and powerful filtering capabilities.","github":"https://github.com/dorkitude/linctl","url":"https://osrepos.com/repo/dorkitude-linctl","source":"osrepos.com","sourceDescription":"This repository profile is provided by osrepos.com, an open source repository discovery platform.","repositoryProfile":"https://osrepos.com/repo/dorkitude-linctl","generatedFor":"open source discovery and AI-assisted research","markdown":"https://osrepos.com/repo/dorkitude-linctl.md","json":"https://osrepos.com/repo/dorkitude-linctl.json","topics":["Go","CLI","Linear API","Issue Tracking","Project Management","Automation","Developer Tools"],"keywords":["Go","CLI","Linear API","Issue Tracking","Project Management","Automation","Developer Tools"],"stars":null,"summary":"linctl is a robust command-line interface designed for managing Linear's API, catering to both automated agents and human users. Built in Go with Cobra, it offers extensive features for issue, project, and team management. This tool streamlines Linear workflows, providing flexible output formats and powerful filtering capabilities.","content":"## Introduction\n\n`linctl` is a comprehensive command-line interface for interacting with Linear's API. Developed in Go with the Cobra framework, it's designed to be highly efficient and versatile, making it suitable for both developer workflows and automated scripting. It provides a rich set of commands for managing issues, projects, teams, users, and comments directly from your terminal.\n\nKey features include secure authentication via personal API keys, detailed issue management with sub-issue hierarchies and Git branch integration, comprehensive project tracking, and flexible output formats like table, plaintext, and JSON. `linctl` also emphasizes performance with time-based filtering and sorting options, ensuring a smooth experience even with large Linear workspaces.\n\n## Installation\n\nGetting started with `linctl` is straightforward. Choose the method that best suits your environment:\n\n### Homebrew (macOS/Linux)\n\nbash\nbrew tap dorkitude/linctl\nbrew install linctl\nlinctl docs      # Render the README.md\n\n\n### From Source\n\nbash\ngit clone https://github.com/dorkitude/linctl.git\ncd linctl\nmake deps        # Install dependencies\nmake build       # Build the binary\nmake install     # Install to /usr/local/bin (requires sudo)\nlinctl docs      # Render the README.md\n\n\n## Examples\n\n`linctl` offers a wide range of commands to manage your Linear workspace. Here are a few examples to get you started:\n\n### Authentication and User Info\n\nbash\n# Interactive authentication\nlinctl auth\n\n# Check authentication status\nlinctl auth status\n\n# Show current user\nlinctl whoami\n\n\n### Issue Management\n\nbash\n# List all issues (defaults to last 6 months)\nlinctl issue list\n\n# List issues assigned to you, sorted by update date\nlinctl issue list --assignee me --sort updated\n\n# Search issues using Linear's full-text index\nlinctl issue search \"login bug\" --team ENG\n\n# Get issue details (includes git branch, cycle, project, attachments, comments)\nlinctl issue get LIN-123\n\n# Create a new issue and assign it to yourself\nlinctl issue create --title \"Bug fix\" --team ENG --assign-me\n\n# Update issue fields\nlinctl issue update LIN-123 --title \"New title\" --state \"In Progress\" --priority 1\n\n\n### Project and Team Management\n\nbash\n# List all projects, including older ones\nlinctl project list --newer-than all_time\n\n# Get project details by ID\nlinctl project get 65a77a62-ec5e-491e-b1d9-84aebee01b33\n\n# List all teams with issue counts\nlinctl team list\n\n# List team members for a specific team\nlinctl team members ENG\n\n\n### Scripting with JSON Output\n\nbash\n#!/bin/bash\n\n# Get all urgent issues in JSON format and parse with jq\nurgent_issues=$(linctl issue list --priority 1 --json)\necho \"$urgent_issues\" | jq '.[] | select(.assignee == \"me\") | .id'\n\n# Get issue count for different time periods\necho \"Last week: $(linctl issue list --newer-than 1_week_ago --json | jq '. | length')\"\n\n\n## Why Use It\n\n`linctl` stands out as an essential tool for anyone working with Linear, especially those looking to enhance productivity and automation. Its agent-first design, combined with human-friendly features, makes it incredibly versatile. You can streamline daily tasks, automate complex workflows, and integrate Linear data into custom scripts and reports with ease. The tool's focus on performance, flexible output formats (table, plaintext, JSON), and comprehensive filtering capabilities ensures that you can quickly access and manipulate the exact information you need, without being overwhelmed by data. Whether you're a developer, project manager, or an automated system, `linctl` provides the granular control and efficiency required to manage your Linear workspace effectively.\n\n## Links\n\n*   [GitHub Repository](https://github.com/dorkitude/linctl)\n*   [Linear API Documentation](https://developers.linear.app/)\n*   [Issue Tracker](https://github.com/dorkitude/linctl/issues)","metrics":{"detailViews":7,"githubClicks":12},"dates":{"published":null,"modified":"2026-01-01T00:00:51.000Z"}}