# Crux

> Crux — Agentic Tool Manager for Claude Code

- Skill: `crux-cli/crux` (Agent Skill)
- Install (CLI): `npx skillmds@latest add crux-cli/crux`
- Raw SKILL.md: https://api.skillmd.com/api/skills/crux-cli/crux/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: crux-cli (https://skillmd.com/u/crux-cli)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/crux-cli/crux

---

# Crux — Agentic Tool Manager for Claude Code

Crux is a CLI tool for managing MCP servers, skills, and agent tasks.

## Available Commands

### MCP Servers
- `crux mcp search <query>` — Search the MCP Registry
- `crux mcp add <name> --npx <pkg>` — Register an MCP server
- `crux mcp remove <name>` — Unregister an MCP server
- `crux mcp list` — List registered MCP servers
- `crux mcp upgrade` — Update cloned MCP repos
- `crux mcp auth <name>` — Authenticate an MCP server
- `crux mcp auth` — Show authentication status for all MCPs
- `crux mcp status` — Probe all registered MCP servers

### Skills
- `crux skill add <name> --github <repo>` — Register a skill
- `crux skill remove <name>` — Unregister a skill
- `crux skill list` — List registered skills

### Projects
- `crux project create [name]` — Create a new project with crux.json
- `crux project install <name>` — Add MCPs/skills to current project
- `crux project uninstall <name>` — Remove MCPs/skills from project
- `crux project sync` — Generate .mcp.json from crux.json
- `crux project status` — Show project health (MCPs, skills, auth)

### Tasks
- `crux task run <prompt>` — Execute a task in an isolated sandbox
- `crux task init` — Scaffold a run.json template
- `crux task list` — Show past/active runs
- `crux task clean` — Remove completed sandboxes

### System
- `crux init` — Initialize the crux environment
- `crux doctor` — Check crux environment health
- `crux version` — Show version and check for updates

## Usage Notes

- Run `crux init` first to set up the `~/.crux/` directory.
- Use `crux mcp search` to discover MCPs, then `crux mcp add` to register them.
- Use `--keychain VAR1,VAR2` with `crux mcp add` to declare and prompt for auth inline.
- Use `crux mcp auth <name>` to re-authenticate or rotate credentials later.
- Use `crux project create` to start a project, then `crux project install` to add MCPs.
- Secrets are stored in the system keychain (macOS) or secret-service (Linux).