Documentation

Everything you need to use PrismCode effectively.

Quick Start

PrismCode runs in your terminal, inside your project directory. Get started in seconds:

$ npx @prismcode543/cli

Or install globally:

$ npm install -g @prismcode543/cli

$ cd my-project

$ prismcode

Requires Bun runtime. On first run, you will be prompted to configure your AI provider API keys.

Commands

All commands are accessed from inside a session via Ctrl+P:

Command	Description
/new	Start a new session
/agents	Switch between Build / Plan mode
/models	Change the AI model
/sessions	Browse past sessions
/search	Search across all sessions
/theme	Change the color theme
/login	Authenticate with Clerk
/logout	Clear authentication
/upgrade	Purchase credits
/usage	View credit usage

Tab Toggle Build / Plan modeEsc Cancel streaming response

Configuration

Create a prismcode.json in your project root:

{
  "model": "claude-sonnet-4-6",
  "mode": "BUILD",
  "maxSteps": 10,
  "toolConfirmation": true,
  "costEstimation": true,
  "timeout": {
    "bash": 30000,
    "readFile": 10000
  },
  "ignore": ["node_modules", ".git", "dist"]
}

All fields are optional. Defaults are used for missing values.

Options

model

AI model to use (e.g. claude-sonnet-4-6, gpt-5, gemini-2.5-pro)

mode

BUILD (execute) or PLAN (review only)

maxSteps

Max iterations before asking for confirmation

toolConfirmation

Require confirmation before tool execution

costEstimation

Show cost estimate before each step

timeout.bash

Max ms for bash commands (default 30000)

timeout.readFile

Max ms for file reads (default 10000)

ignore

Glob patterns to exclude from context

Environment Variables

Configure AI providers and services via .env in your project root:

Variable	Provider	Required
ANTHROPIC_API_KEY	Anthropic (Claude)	At least one
OPENAI_API_KEY	OpenAI (GPT)	At least one
GOOGLE_API_KEY	Google (Gemini)	At least one
GROQ_API_KEY	Groq (Llama)	At least one
OPENROUTER_API_KEY	OpenRouter	At least one
CLERK_SECRET_KEY	Authentication	For cloud sync
POLAR_ACCESS_TOKEN	Billing	For cloud billing

API Server (Self-Host)

The PrismCode server handles authentication, session persistence, and billing. Run locally with Docker:

git clone https://github.com/j4633705-cloud/Prismcode
cd Prismcode
cp .env.example .env
# Edit .env with your keys
bun install
bun run dev:server

Using Docker:

docker build -t prismcode/server .
docker run -p 3001:3001 prismcode/server

Required variables for self-host:

DATABASE_URL — PostgreSQL connection string
CLERK_SECRET_KEY — Clerk secret key
CLERK_PUBLISHABLE_KEY — Clerk publishable key
API_URL — Your server URL (e.g. http://localhost:3001)

Local Development

git clone https://github.com/j4633705-cloud/Prismcode
cd Prismcode
cp .env.example .env
bun install
bun run dev:server   # Terminal 1
bun run dev:cli      # Terminal 2

The CLI runs standalone without the server. Only start the server if you want cloud sync or billing.

Need help?

Join our GitHub Discussions or open an issue on GitHub.