Installation | VitaeContext

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

Instead of installing skill files into project directories, connect your AI coding assistant over Model Context Protocol with zero workspace pollution:

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.