CODEBOLT SDK

The SDK layer for scalable agent software

Build custom agents, custom clients, plugins, providers, and Codebolt-native applications on top of the same engine that powers the Editor, CLI, Cloud, and autonomous agents.

01
Agent SDK
02
Client SDK
03
Plugin SDK
04
Provider SDK

The SDK is the scalability layer of Codebolt. Use the Agent SDK and agent framework to control agent behavior, the Client SDK to build custom interfaces and integrate other applications, the Plugin SDK to extend the engine, and the Provider SDK to connect agent execution across platforms and environments.

SDK LAYERS

Build at every layer of the engine

Codebolt is not just an app with an API. It exposes the layers you need to create agents, build interfaces, extend runtime behavior, connect external systems, and scale execution.

codeboltjs

Agent SDK

Use codeboltjs to create custom agents with direct access to files, git, terminal, browser, LLMs, memory, tasks, dynamic panels, environments, evals, and engine APIs.

Agent SDK module access A custom agent calls codeboltjs modules for files, git, terminal, LLM, browser, memory, tasks, jobs, panels, and environments. AGENT SDK Custom agent codeboltjs files + git terminal LLM + browser memory tasks + jobs panels + envs
@codebolt/agent

Agent framework

Build agents like you would with LangChain, Mastra, or other frameworks, but Codebolt-aware. Compose tools, workflows, processors, message modifiers, compaction, and execution control for agents tailored to your workflow.

Agent framework composition The agent framework composes tools, workflows, processors, message modifiers, compaction, and execution control. AGENT FRAMEWORK @codebolt agent tools workflows processors compaction modifiers control
Custom clients

Client SDK

Use the Client SDK to build custom web apps, internal tools, dashboards, vertical IDEs, mobile surfaces, or product integrations that talk to Codebolt over REST and WebSocket APIs.

Client SDK custom interfaces Custom web apps, dashboards, vertical IDEs, and mobile surfaces connect to Codebolt through REST and WebSocket APIs. CLIENT SDK Web app Dashboard Mobile surface REST WebSocket Engine state
Runtime extension

Plugin SDK

Use the Plugin SDK to add backend capabilities, commands, routes, hooks, dynamic panels, provider integrations, marketplace packages, and app-specific runtime logic.

Plugin SDK runtime extension Plugins add routes, hooks, dynamic panels, commands, external adapters, marketplace packages, and runtime backend logic. PLUGIN SDK Plugin engine process backend logic routes hooks panels commands adapters packages
Agent routing

Provider SDK

Create custom agent providers and execution bridges so Codebolt can chain agent connections across platforms, environments, remote servers, and specialized runtimes.

Provider SDK execution routing The provider SDK routes agent execution to local engines, remote servers, cloud sandboxes, custom platforms, and specialized runtimes. PROVIDER SDK Provider route request local engine remote server cloud sandbox custom platform
Composable

Native applications

Combine SDK layers to create Codebolt-native applications: a custom app UI, plugin backend, custom agents, provider routing, and cloud or self-hosted execution on the same engine.

Native application composed from SDK layers A native application combines client SDK UI, plugin backend, custom agents, provider routing, and Codebolt engine services. NATIVE APPLICATION Client UI Plugin backend Agents Providers Engine
01
AGENT SDK

Create custom agents tailored to your workflow

Codebolt lets teams build agents the way they build software: with code, modules, tools, workflows, and explicit control over the agent loop. The codeboltjs Agent SDK gives agents direct access to Codebolt engine capabilities, while the @codebolt/agent framework provides a higher-level interface for tools, workflows, reusable processor pieces, message modifiers, loop detection, and conversation compaction. Use it when a generic prompt is not enough and the agent needs to follow your product, team, or domain workflow.

Read codeboltjs docs
Custom agent flow controlled by Agent SDK and framework Instructions, allowed tools, modifiers, processors, workflows, compaction, and engine modules shape custom agent behavior. AGENT SDK + FRAMEWORK instructions allowed tools modifiers processors Agent loop workflows compaction engine modules Custom behavior
02
CLIENT SDK

Build your own interfaces and integrations

The Editor and CLI are clients of the engine. With the Client SDK, your application can be one too. Build a custom UI, vertical workspace, internal operations console, product-specific dashboard, or integration from another application. The client layer can call Codebolt APIs, subscribe to real-time sockets, manage threads, tasks, jobs, agents, environments, memory, git, files, and application state.

Explore native apps
Client SDK custom interface connected to engine APIs A custom application uses REST and WebSocket APIs through the Client SDK to manage chat, agents, jobs, files, git, memory, environments, and state. CLIENT SDK your application REST and WebSocket threads agents + jobs files + git memory state
03
PLUGIN SDK

Extend the runtime, not just the UI

Plugins let you add capabilities inside the Codebolt engine itself. A plugin can expose routes, connect to external APIs, register hooks, open dynamic panels, mediate application requests, push live events, add provider behavior, and serve as the backend for a Codebolt-native application. That means your product logic can live close to agents, memory, tasks, environments, and execution rather than in a disconnected service.

Read plugin docs
Plugin SDK runtime backend capabilities A plugin process provides lifecycle hooks, routes, WebSocket events, commands, panels, external adapters, and engine API access for apps and agents. PLUGIN RUNTIME Plugin process backend inside engine close to agents and memory lifecycle HTTP routes WS + mux hooks panels adapters engine API
04
PROVIDER SDK

Route agent execution across platforms

The provider layer lets Codebolt connect to execution sources beyond one local runtime. Build custom providers to bridge agent connections across platforms, environments, remote machines, cloud sandboxes, or specialized agent systems. This is how the SDK story becomes a scaling story: agent work can move through the right provider instead of being trapped inside one client or one machine.

Read provider commands
Provider SDK routes execution across backends Codebolt sends an execution request through the provider layer to local engines, remote servers, cloud sandboxes, custom agent platforms, or specialized runtimes. PROVIDER ROUTING Codebolt execution request Provider choose backend local remote server cloud sandbox agent platform specialized
05
CODEBOLT-NATIVE APPS

Combine SDKs into full applications

The real power appears when the SDK layers are used together. Use the Agent SDK to control the agent flow, the Plugin SDK to provide backend application logic, the Client SDK to create the interface, and the Provider SDK to route execution across environments. The result is a Codebolt-native application: software that uses the Codebolt engine as its backend instead of rebuilding agents, plugins, memory, tasks, orchestration, and scaling from scratch.

Open native applications page
Codebolt-native application architecture Client SDK, Plugin SDK, Agent SDK, Provider SDK, and Codebolt engine services combine into a native application. CODEBOLT-NATIVE APPLICATION Client SDK Plugin SDK Agent SDK Provider SDK Codebolt engine services memory + tasks + jobs + plugins + tools + environments + evals
WHAT YOU CAN BUILD

The SDK is for scaling beyond the default surfaces

Use SDKs when you need something more specific than a stock editor, one terminal session, or one hosted agent.

Agents

Workflow-specific agents

Create agents for code review, migration, compliance, support, research, release management, data labeling, product planning, or any domain workflow.

Workflow-specific agents Domain workflows such as review, migration, compliance, support, research, and release management become custom agents. WORKFLOW AGENTS Agent workflow review migration support release
Clients

Custom product interfaces

Build your own UI on top of Codebolt: dashboards, vertical IDEs, internal portals, mobile apps, customer-facing tools, or embedded product surfaces.

Custom product interfaces Dashboards, vertical IDEs, internal portals, mobile apps, customer-facing tools, and embedded surfaces connect through the Client SDK. CUSTOM INTERFACES web + mobile + embedded product surfaces
Plugins

Engine extensions

Add integrations, routes, panels, hooks, commands, marketplace packages, backend logic, and domain capabilities directly into the engine runtime.

Engine extensions Integrations, routes, panels, hooks, commands, marketplace packages, backend logic, and domain capabilities run inside the engine runtime. ENGINE EXTENSIONS Plugin extension routes hooks panels commands packages
Providers

Execution bridges

Route agent work to local runtimes, cloud sandboxes, remote servers, or third-party agent platforms using custom providers.

Execution bridges Custom providers bridge agent work from Codebolt to local runtimes, cloud sandboxes, remote servers, and third-party agent platforms. EXECUTION BRIDGES Provider local runtime cloud sandbox remote server agent platform
Native apps

Packaged engine apps

Package Codebolt into your own application or make Codebolt itself become the shell for your app through panels, plugins, and custom clients.

Packaged engine apps Codebolt can be packaged into an application shell with panels, plugins, custom clients, and engine services. PACKAGED ENGINE APP shell client plugin engine
Scale

Scalable agent systems

Grow from one custom agent to multi-agent, multi-environment workflows without changing the foundation.

Scalable agent systems A custom agent scales into multi-agent and multi-environment workflows on the same foundation. SCALABLE SYSTEMS one multi-agent envs
Single-surface agent tools RISK: HIGH
x

Let you use their agent, but not build your own agent runtime around your workflow

x

Expose a fixed UI instead of a client SDK for custom applications

x

Treat plugins as add-ons instead of runtime backends

x

Do not provide a provider layer for chaining execution across platforms

x

Force teams to rebuild memory, tasks, jobs, orchestration, and scaling around the tool

Codebolt SDK RISK: MITIGATED

Agent SDK and framework let you control agent flow, tools, processors, workflows, and compaction

Client SDK lets you build custom interfaces and integrate Codebolt into other applications

Plugin SDK lets you extend the engine and run app backend logic inside the runtime

Provider SDK lets you bridge agent execution across environments and platforms

Together, the SDK layers let teams build Codebolt-native applications that scale with the engine

Build on the engine. Scale beyond the default app.