Usage
Crystal Code runs in the workspace you want the agent to inspect or change. This section covers the operator-facing behavior: configuration, credentials, the interactive session, approval, context, tools, prompts, skills, sessions, and local data.
Set up the operator space
Section titled “Set up the operator space”Configuration
Host settings, provider definitions, model fields, and examples.
KeysCredentials
Persistent API keys, environment overrides, and resolution order.
ModelsModels
Switch providers and models for the next idle turn.
Run a session
Section titled “Run a session”Interactive session
Prompts, attachments, streaming output, and terminal controls.
ModesModes
Plan reads and plans; Work can edit files and run shell commands.
ApprovalApproval
Classify side effects, review them, or pass them through by policy.
ThinkingThinking
Select a thinking gear for the current model.
ContextContext budgets
Declare selectable local budgets and switch between them.
ResumeSessions
Resume, fork, name, and inspect saved sessions.
CompactionCompaction
Summarize older context and remove old tool results.
Tools and prompts
Section titled “Tools and prompts”Slash commands
Built-in verbs, model selection, context, and session controls.
ToolsBuilt-in tools
Read, list, tree, glob, grep, search, edit, write, bash, and more.
ToolsExternal tools
Add model-callable tools as operator tool sets.
PluginsPlugins
Add in-process extensions from the home or project tree.
PromptsPrompts and instructions
Replace prompt slots, add instructions, and attach prompt files.
SkillsSkills
Load Markdown instructions on demand through the skill tool.