Crux

Agentic Tool Manager for Claude Code

A CLI tool for macOS and Linux that brings package‑management to your Claude Code agentic workflows. Add MCP servers and skills to a local registry, scope them per project, and keep credentials in your OS keychain — never in files.

Get started Install

claude plugin marketplace add crux-cli/claude-marketplace && claude plugin install crux

or curl -LsSf https://raw.githubusercontent.com/crux-cli/crux/main/install.sh | sh

One registry, every project

Add MCP servers and skills once — from npm, PyPI, GitHub, or local sources. Use them across all your projects without copy‑pasting config files.

Secrets in your keychain

API keys live in macOS Keychain, Linux Secret Service, or an age‑encrypted vault. Launcher scripts fetch them at runtime. Nothing touches disk.

Scoped per project

Each project declares its tools in crux.json. Agents see only what’s declared — fewer tools means better outputs and tighter security.

Sandboxed execution

crux task run creates isolated environments with pre‑flight validation. Misconfigurations are caught before your agent starts.

Health monitoring

crux project status probes every MCP via JSON‑RPC. crux doctor validates your environment and auto‑fixes what it can.

Discover & search

Search the official MCP registry directly from your terminal. Find servers, get suggested install commands, add with one line.

How it works

Build your registry

Add MCP servers and skills from any source. You do this once — they’re available to every project.

crux mcp add filesystem --npx @modelcontextprotocol/server-filesystem
crux mcp add wikijs --github jaalbin24/wikijs-mcp-server
crux skill add autoresearch --github user/autoresearch-skill

Authenticate your MCPs

API keys go in your OS keychain. Crux generates launcher scripts that fetch them at runtime.

crux mcp auth wikijs
crux mcp auth github

Use in a project or a one‑off sandbox

Project mode — declare what each project needs in a crux.json manifest. Crux generates the .mcp.json that Claude Code expects.

crux project create homelab-assistant && cd homelab-assistant
crux project install wikijs filesystem autoresearch
crux project status

Sandbox mode — run an agent with a specific set of tools, without setting up a project. Pre‑flight checks catch problems before execution.

crux task run "Update the wiki with latest research" \
  --mcps wikijs --skills autoresearch