Installation

Lineup 2.0 is installed and managed via the lineup CLI.

Prerequisites

• Node.js 20+
• Claude Code CLI for Claude host operations
• Codex CLI for Codex host operations
• OpenCode for OpenCode host operations

Install the manager

npm install -g @izantech/lineup-cli

Where install files come from

lineup install and lineup update fetch release artifacts from GitHub and cache them locally per tag in ~/.lineup/cache/<tag>/.

Lineup does not embed canonical workflow files inside the npm package. For full details, see CLI Manager Reference.

Install Lineup

Install for all hosts:

lineup install --host all

Install for one host:

lineup install --host claude
lineup install --host codex
lineup install --host opencode

If --host is omitted in a TTY, Lineup prompts for host selection. In non-TTY mode, --host is required.

Update

lineup update --host all
lineup update --host claude --version latest

Status

lineup status --host all
lineup status --host all --json

status --json returns:

• schema_version
• state_file
• hosts.<host>.installed
• hosts.<host>.version
• hosts.<host>.source
• hosts.<host>.last_action
• hosts.<host>.error (optional)

Uninstall

lineup uninstall --host all

Uninstall is interactive by default and always asks for confirmation.

Non-interactive:

lineup uninstall --host all --yes

Purge Lineup-owned data paths:

lineup uninstall --host all --yes --purge

Purge targets:

• ~/.claude/lineup/agents/
• ~/.codex/lineup/agents/
• ~/.codex/lineup/memory/
• ~/.config/opencode/lineup/

Notes on host installs

• Claude installs are CLI-managed local marketplace/plugin installs.
• Codex installs are global skills in $HOME/.codex/skills/lineup-*.
• Codex installs are global-only; repo-local Codex skill directories are not supported.
• OpenCode installs are global skills in ~/.config/opencode/skills/, one directory per skill.
• Existing legacy Claude marketplace installs are detected and can be migrated.

Install-time model configuration

All three host installers prompt for model IDs on first install and persist the answers:

Host	Config file	Prompts	Defaults
Claude	~/.claude/lineup/install-config.yaml	opus / sonnet / haiku	claude-opus-4-7 / claude-sonnet-4-6 / claude-haiku-4-5
Codex	~/.codex/lineup/install-config.yaml	opus / sonnet / haiku	gpt-5.5 xhigh / gpt-5.5 medium / gpt-5.4-mini low
OpenCode	~/.config/opencode/lineup/install-config.yaml	regular / mini	none

Reinstalls reuse the persisted config. To be re-prompted, delete the config file before running lineup install.

Troubleshooting

lineup: command not found

• Ensure your global npm bin is in PATH.
• Reinstall: npm install -g @izantech/lineup-cli

Claude status shows a legacy install

Run install and accept migration prompt:

lineup install --host claude

Codex skills are missing

lineup status --host codex
lineup install --host codex --yes

OpenCode skills are missing

lineup status --host opencode
lineup install --host opencode --yes

Next step

Go to Your First Task.