ln-011-agent-installer

Original：🇺🇸 English

Translated

Installs or updates Codex CLI, Gemini CLI, and Claude Code. Use when CLI agents need installation or update.

2installs

Sourcelevnikolaevich/claude-code-skills

Added on2026-03-25

NPX Install

npx skill4agent add levnikolaevich/claude-code-skills ln-011-agent-installer

SKILL.md Content

View Translation Comparison →

Paths: File paths (
shared/
,
references/
) are relative to skills repo root. Locate this SKILL.md directory and go up one level for repo root.

Agent Installer

Type: L3 Worker Category: 0XX Shared

Installs or updates CLI agents via npm and Claude CLI. Single pass per agent: install then immediately verify.

Input / Output

Direction	Content
Input	OS info, `disabled` flags per agent, `dry_run` flag
Output	Per-agent status: `installed` / `updated` / `skipped` / `disabled` / `failed`

Agent Registry

Agent	Install Command	Health Check
Codex	`npm i -g @openai/codex`	`codex --version`
Gemini	`npm i -g @google/gemini-cli`	`gemini --version`
Claude	`claude update`	`claude --version`

Workflow

For each agent: Install → Verify → Record

Phase 1: Install & Verify

For each agent in registry, apply first matching rule:

Condition	Action	Report
`disabled: true`	SKIP	"disabled by user"
`dry_run: true`	Show planned command	"dry run"
npm agent	`npm install -g {pkg}` then `{cmd} --version`	version or error
Claude	`claude update` then `claude --version`	version or error

Single pass: install and verify happen atomically per agent. No separate scan phase — the install result IS the state.

Error handling:

Error	Detection	Response
npm not in PATH	`npm --version` fails	FAIL gracefully, report "npm not found in PATH"
Permission denied	stderr contains "EACCES"	FAIL, suggest `npm install -g --prefix ~/.local {pkg}`
Network error	stderr contains "ETIMEDOUT" or "ENETUNREACH"	FAIL, report "network error"
Unknown error	Any other non-zero exit	FAIL, include stderr

Output table:

Agent Installation:
| Agent  | Action    | Version  | Status |
|--------|-----------|----------|--------|
| Codex  | installed | 0.1.2503 | ok     |
| Gemini | skipped   | -        | disabled by user |
| Claude | updated   | 1.0.30   | ok     |

Critical Rules

Never modify
disabled
flags. Respect them, never change them
Fail gracefully. One agent failure does not block others
Global install only. Always
```
npm install -g
```
(CLI tools must be in PATH)
No side effects. Only npm global packages touched. No config files modified
Idempotent. Safe to run multiple times

Anti-Patterns

DON'T	DO
Separate check/install/verify phases	Single pass: install then verify
Retry failed installs automatically	One attempt, report failure
Use `sudo npm install`	Suggest `--prefix` for permission issues
Install agents marked `disabled`	Skip with clear report

Definition of Done

All agents processed in single pass (install + verify)
Disabled agents skipped with report
Version verified immediately after each install
Status table displayed

Version: 1.1.0 Last Updated: 2026-03-23