codeboltai/codebolt-api-access

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?.();
});