Getting Started

Lobu is the open-source backend for organizational agents. One agent definition serves team chat, the web app, and your own application — with shared memory, permissions, and automations across every surface.

Login to Lobu Managed Cloud runtime Try on Slack Hosted Lobu bot Try on Telegram Hosted Lobu bot >_ Run locally CLI or Docker

Use it with your own agent

The fastest way to try Lobu is to install its skill into a coding agent you already use. The skill teaches Claude Code, Cursor, Codex, OpenCode, or OpenClaw how to scaffold and drive a Lobu project.

npx skills add lobu-ai/lobu --skill lobu

That adds a Lobu skill your assistant can invoke — it knows the project layout, config API, connectors, memory, automations, and evals. See Skills.

You’ll usually develop through that agent: it scaffolds the project, then edits config, skills, connectors, memory, and automations as you ask. Nothing it does stays hidden — every change is a file in your project you can open and inspect, and you can run the app locally (or in Docker) whenever you want to see it live.

Run locally

Install the CLI for an interactive project, or self-host the whole app in a container.

CLIDocker

1. Install the CLI

# Run directly — no install
npx @lobu/cli@latest <command>

# Or install globally
npm install -g @lobu/cli

See the CLI reference.

2. Scaffold and run a project

npx @lobu/cli@latest init my-agent
cd my-agent
npx @lobu/cli@latest run

init writes lobu.config.ts with the agent defined and scaffolds agents/my-agent/. run boots the gateway on http://localhost:8787, signs you into a local context, and provisions the agent.

3. Talk to it

npx @lobu/cli@latest chat "Hello, what can you do?"

chat resolves my-agent from the config and talks to the local gateway. Run init and run first — chat on its own fails with "No agent specified".

Connect an MCP client or embed

MCP clients Point ChatGPT, Claude, Codex, Grok, or OpenClaw at https://lobu.ai/mcp and sign in. Browse agents & clients → TypeScript Call agents from your own app with @lobu/client and stream replies. Embed into your app → CLI tools Run the same MCP tools from the terminal — lobu memory run search_memory '{"query":"Acme"}'. MCP reference →

Add capabilities

Connect data and chat Slack, Telegram, GitHub, Gmail, and more. Connectors → Shared memory Durable entities, facts, and decisions agents read across sessions. Memory → Automations Scheduled and event-driven jobs with approvals and notifications. Automations → Author a connector Turn any API into a Lobu connector. Connector SDK → Evals Lock in quality as autonomy grows. Evaluations →

Understand the system

Connectors bring events in, memory keeps durable context, and agents and automations read and act — replies and actions become new events, closing the loop. Concepts →