asdf-linctl

asdf plugin for linctl - A comprehensive Linear CLI tool.

Install

Plugin

asdf plugin add linctl https://github.com/delphos-mike/asdf-linctl.git

linctl

# Show all available versions
asdf list all linctl

# Install latest version
asdf install linctl latest

# Install specific version
asdf install linctl 0.2.0

# Set global version
asdf global linctl 0.2.0

# Set local version (in current directory)
asdf local linctl 0.2.0

Requirements

• Go 1.23+ (required for building from source)
• curl (for downloading releases)
• tar (for extracting archives)

Usage

After installation, linctl will be available in your PATH:

# Verify installation
linctl --version

# Authenticate with Linear
linctl auth

# Use linctl commands
linctl issue list
linctl project list
linctl whoami

Configuration

linctl stores configuration in ~/.config/linctl/config.yaml.

Get your Linear API key from: https://linear.app/settings/api

How It Works

This plugin:

1. Downloads source code from GitHub releases
2. Builds linctl from source using Go
3. Installs the binary to asdf's managed location
4. Makes it available via asdf shims

Version Management

# List installed versions
asdf list linctl

# Install multiple versions
asdf install linctl 0.2.0
asdf install linctl 0.1.1

# Switch between versions
asdf global linctl 0.2.0
asdf local linctl 0.1.1

# Uninstall a version
asdf uninstall linctl 0.1.1

Troubleshooting

Go not found

If you get "Go is required to build linctl":

# Install Go via asdf
asdf plugin add golang
asdf install golang latest
asdf global golang latest

Build failures

If the build fails:

1. Ensure Go 1.23+ is installed: go version
2. Check Go module cache: go clean -modcache
3. Try installing again: asdf install linctl <version>

Authentication issues

If linctl can't authenticate:

1. Run linctl auth to set up your API key
2. Verify the key is saved: cat ~/.config/linctl/config.yaml
3. Get a new key from: https://linear.app/settings/api

Links

• linctl repository
• Linear API documentation
• asdf documentation

License

MIT License - see LICENSE file for details.