Codebolt API Access

This skill provides reference documentation for direct TypeScript SDK calls to codebolt modules.

Quick Start

File System

import codebolt from '@anthropic/codeboltjs';

// Read and write files const content = await codebolt.fs.readFile('/path/to/file.ts'); await codebolt.fs.createFile('newfile.ts', 'const x = 1;', '/path/to/dir');

// Search files const results = await codebolt.fs.grepSearch('/src', 'function', '*.ts');

Browser

import codebolt from '@anthropic/codeboltjs';

await codebolt.browser.goToPage('https://example.com'); const screenshot = await codebolt.browser.screenshot(); const markdown = await codebolt.browser.getMarkdown(); await codebolt.browser.close();

Terminal

import codebolt from '@anthropic/codeboltjs';

const result = await codebolt.terminal.executeCommand('npm install'); const stream = codebolt.terminal.executeCommandWithStream('npm run dev'); stream.on('commandOutput', (data) => console.log(data));

Git

import codebolt from '@anthropic/codeboltjs';

await codebolt.git.init('/path/to/project'); await codebolt.git.addAll(); await codebolt.git.commit('Add new feature'); await codebolt.git.push(); const status = await codebolt.git.status();

LLM

import codebolt from '@anthropic/codeboltjs';

const response = await codebolt.llm.inference({ messages: [ { role: 'system', content: 'You are a helpful assistant.' }, { role: 'user', content: 'What is TypeScript?' } ], tool_choice: 'auto', max_tokens: 1000, temperature: 0.7 }); console.log(response.completion.content);

Thread

import codebolt from '@anthropic/codeboltjs';

const thread = await codebolt.thread.createThread({ name: 'Feature Discussion', threadType: 'discussion', agentId: 'agent-123' });

await codebolt.thread.startThread(thread.thread.id, { initialMessage: 'Lets discuss new feature requirements.' });

const messages = await codebolt.thread.getThreadMessages({ threadId: thread.thread.id, limit: 50 });

Swarm

import codebolt from '@anthropic/codeboltjs';

const swarm = await codebolt.swarm.createSwarm({ name: 'Processing Swarm', allowExternalAgents: false, maxAgents: 10 });

const agent = await codebolt.swarm.registerAgent(swarm.data.swarm.id, { name: 'Agent Alpha', agentType: 'internal' });

const team = await codebolt.swarm.createTeam(swarm.data.swarm.id, { name: 'Processing Team', maxMembers: 5 });

const role = await codebolt.swarm.createRole(swarm.data.swarm.id, { name: 'Data Processor', permissions: ['task:execute', 'data:read'], maxAssignees: 5 });

Job

import codebolt from '@anthropic/codeboltjs';

const group = await codebolt.job.createJobGroup({ name: 'Data Processing Jobs' });

const job = await codebolt.job.createJob(group.data.groupId, { title: 'Process dataset', priority: 'high', estimatedHours: 2 });

await codebolt.job.addDependency(job.data.job.id, otherJobId, 'finish_to_start'); await codebolt.job.lockJob(job.data.job.id, 'agent-001', 'Worker Agent'); await codebolt.job.unlockJob(job.data.job.id, 'agent-001');

MCP Tools

import codebolt from '@anthropic/codeboltjs';

const enabled = await codebolt.mcp.getEnabledMCPServers(); const tools = await codebolt.mcp.listMcpFromServers(['filesystem', 'browser']);

const result = await codebolt.mcp.executeTool( 'filesystem', 'read_file', { path: '/path/to/file.ts' } );

Auto Testing

import codebolt from '@anthropic/codeboltjs';

const suite = await codebolt.autoTesting.createSuite({ name: 'Authentication Tests' });

const testCase = await codebolt.autoTesting.addCaseToSuite(suite.data.suite.id, { name: 'Valid login', steps: ['Navigate', 'Enter credentials', 'Click login'], expectedResult: 'Redirected to dashboard' });

const run = await codebolt.autoTesting.createRun({ suiteId: suite.data.suite.id, name: 'Test Run 001' });

Memory

import codebolt from '@anthropic/codeboltjs';

// Store JSON data await codebolt.memory.json.save({ theme: 'dark' }, { type: 'config' }); const saved = await codebolt.memory.json.list({ type: 'config' });

// Store markdown notes await codebolt.memory.markdown.save('# Notes', { topic: 'meetings' }); const notes = await codebolt.memory.markdown.list({ tags: ['meetings'] });

Module Reference

Module Description Reference

codebolt.fs

File system operations (read, write, search, diff) fs.md

codebolt.browser

Browser automation (navigation, screenshots, DOM) browser.md

codebolt.terminal

Command execution (sync, async, streaming) terminal.md

codebolt.git

Git operations (init, clone, commit, push, pull) git.md

codebolt.chat

Chat & WebSocket communication (messages, process lifecycle, notifications) chat.md

codebolt.project

Project management (settings, path, repo map, execution) project.md

codebolt.llm

LLM inference with tools and model configuration llm.md

codebolt.agent

Agent discovery and execution (find, start, list agents) agent.md

codebolt.thread

Thread management (create, start, update, delete, messages) thread.md

codebolt.todo

Todo list management (add, update, delete, export, import) todo.md

codebolt.memory

Persistent memory storage (JSON, Markdown, Todo formats) memory.md

codebolt.task

Task management (create, update, delete, assign, execute) task.md

codebolt.codeutils

Code analysis, matching, and markdown generation codeutils.md

codebolt.search

Web search operations search.md

codebolt.job

Job management with pheromones, bidding, locks, blockers job.md

codebolt.swarm

Swarm orchestration with teams, roles, vacancies swarm.md

codebolt.orchestrator

Orchestrator management and control orchestrator.md

codebolt.requirementPlan

Requirement plan document management (sections, review) requirementPlan.md

codebolt.actionPlan

Action plan workflow management (tasks, groups, execution) actionPlan.md

codebolt.actionBlock

Action block management and execution actionBlock.md

codebolt.codebaseSearch

Semantic code search and MCP tool search codebaseSearch.md

codebolt.mcp

MCP server and tool management (configure, list, execute) mcp.md

codebolt.autoTesting

Automated testing (suites, cases, runs) autoTesting.md

codebolt.hook

Hook management (event triggers, actions, conditions) hook.md

codebolt.crawler

Web crawler automation (start, navigate, scroll, click, screenshot) crawler.md

codebolt.vectordb

Vector database operations (store, retrieve, query vectors) vectordb.md

codebolt.history

Chat history summarization (full history, partial history) history.md

codebolt.rag

RAG system (placeholder) rag.md

codebolt.roadmap

Roadmap management (phases, features, ideas) roadmap.md

codebolt.reviewMergeRequest

Review and merge request management (create, review, merge, track) reviewMergeRequest.md

codebolt.knowledge

Knowledge base (placeholder) knowledge.md

codebolt.dbmemory

In-memory key-value database operations dbmemory.md

Common Patterns

File Operations

// Read, write, and search files const content = await codebolt.fs.readFile('/path/to/file.ts'); await codebolt.fs.updateFile('file.ts', '/path/to', newContent); const results = await codebolt.fs.grepSearch('/src', 'function', '*.ts');

Browser Automation

// Navigate, capture content, screenshot await codebolt.browser.goToPage('https://example.com'); const markdown = await codebolt.browser.getMarkdown(); await codebolt.browser.screenshot({ fullPage: true });

Command Streaming

// Stream command output const stream = codebolt.terminal.executeCommandWithStream('npm test'); stream.on('commandOutput', (data) => console.log('Output:', data)); stream.on('commandFinish', (data) => { console.log('Finished:', data); stream.cleanup?.(); });