Documentation ยท installation

Install VitaeContext

Choose the provider where your agent runs. The package installs readable skill folders and provider-specific wrappers.

Install from npm

Use the provider matching your agent environment:

npx vitaecontext install --provider codex

Replace codex with another supported value listed below.

Supported provider values

codexCodex~/.agents/skills/ + CODEX_HOME/skills or ~/.codex/skills/
claude-codeClaude Code~/.claude/skills/
cursorCursor~/.cursor/skills/ or .cursor/skills/
windsurfWindsurf~/.codeium/windsurf/skills/ or .windsurf/skills/
roo-codeRoo Code / Cline~/.config/roo-code/skills/ or .roo/skills/
gemini-cliGemini CLI~/.gemini/extensions/vitaecontext/
antigravityAntigravity~/.gemini/antigravity-cli/plugins/vitaecontext/
opencodeOpenCode~/.config/opencode/skills/
ibm-bobIBM Bob~/.ibm/skills/ or .ibm/skills/
grokxAI Grok~/.grok/skills/ or .grok/skills/
sharedShared bundlerequires --target-dir

See provider-specific commands and invocation examples.

Model Context Protocol (MCP) Server

Connect a compatible agent to selected local Career Context and VitaeGraph files over the stateless Model Context Protocol server:

npx -y vitaecontext mcp

See the full MCP setup guide for Claude Desktop, Cursor, Windsurf, Roo Code, and more.

Claude Code marketplace

Claude Code also supports a plugin marketplace installation:

/plugin marketplace add vitaecontext/vitaecontext
/plugin install vitaecontext@vitaecontext

Codex plugin marketplace

A cloned product repository includes a native Codex plugin backed by the same canonical skills:

codex plugin marketplace add .agents/plugins
codex plugin add vitaecontext@vitaecontext

Direct npm skill installation remains supported and does not require the plugin marketplace.

Local checkout

Maintainers can test an unpublished checkout from the product repository:

git clone https://github.com/vitaecontext/vitaecontext.git
cd vitaecontext
npx . install --provider codex

Useful install flags

--project-root <dir>
Install relative to a project instead of the global default.
--target-dir <dir>
Use an exact skill destination. Required for the shared provider.
--commands-target-dir <dir>
Override command-wrapper placement where supported.
--force
Replace existing VitaeContext files without prompting.