Getting Started

Installation

Install Contxt globally via npm.

Requirements

  • Node.js 18 or higher
  • npm, pnpm, or yarn

Install

npm install -g @mycontxt/cli

Or with pnpm:

pnpm add -g @mycontxt/cli

Verify Installation

contxt --version

You should see the current version number.

Authentication (Optional)

To sync context to the cloud and use Smart Suggest with semantic search, authenticate with your Contxt account:

contxt auth login

This opens a browser window for GitHub OAuth. Once authenticated, your context syncs across machines and team members.

Local-first design
Local-only usage works without authentication. All CLI commands function offline — cloud sync is additive.

Updating

npm update -g @mycontxt/cli

Uninstall

npm uninstall -g @mycontxt/cli

This removes the CLI but preserves any .contxt/ directories in your projects.