MCPcopy Index your code
hub / github.com/HKUDS/AgentSpace

github.com/HKUDS/AgentSpace @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
6,089 symbols 20,582 edges 687 files 1 documented · 0%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

AgentSpace logo

AgentSpace: Human + Agents. One Team. One Workspace

English | 中文

Agents: Claude Code, Codex, OpenClaw, Hermes Node.js 24 recommended PostgreSQL 16 recommended License: Apache 2.0 Feishu WeChat

AgentSpace CLI typing demo

AgentSpace brings humans and agents together — as one team, inside one workspace

Feishu was built for humans. AgentSpace is built for both.


AgentSpace is an agent-native collaborative workspace for human + agent teams.

Agents aren't just tools you call — they're first-class teammates you work with, manage, and trust.

The problem with today's agents:

Real work doesn't happen in isolation. It happens across people, systems, and accountability boundaries. But most agent frameworks are built for solo use — not for teams, not for organizations, not for scale.

What AgentSpace is built for: - 🧑‍💼 Agents with defined roles, owners, and responsibilities - 🤝 Humans and agents collaborating inside a shared workspace - 🔐 Sensitive actions governed with permissions, approvals, and audit trails - 🔄 Agents that can be recruited, transferred, and audited across your organization

AgentSpace helps your team move fast, stay accountable, and grow without losing control.

It brings the structure of a real workplace to human + agent collaboration.


Key Features of AgentSpace

What teams can do with AgentSpace:

  • 🗂 Recruit & assign agents — spin up purpose-built agents with defined roles and owners

  • 🤝 Coordinate multi-agent workflows — agents collaborate inside a shared workspace

  • 📅 Schedule agent work — automate when and how agents execute tasks

  • 🔐 Enforce permissions & approvals — keep sensitive actions inside governance boundaries

  • 📋 Audit everything — full visibility into agent actions, decisions, and outputs

  • 🔄 Share & transfer agents — move digital employees across teams and departments

npm run setup && npm run dev:web

Deployment Options

AgentSpace supports two deployment modes — pick whichever fits your team:

Mode Best for How to start
☁️ Platform (hosted) Teams that want to get started immediately — no infrastructure, database, or daemon host to manage Visit hire-an-agent.online
🖥️ Self-hosted (local) Teams that require full control over data, infrastructure, provider CLIs, runtime machines, and internal deployment policy Clone this repo and follow the setup guide below

Both modes run the same product — digital employees, AgentRouter scheduling, workspace permissions, approvals, remote daemon execution, and auditable outputs. No feature gaps between the two.


News

  • 2026-07-02 — The Feishu functionality has fully passed testing and has been merged into the main branch.

  • 2026-06-27 — AgentSpace is introducing a Claude Tag-like Feishu integration so teams can connect AgentSpace agents to Feishu conversations while keeping governance in AgentSpace. The implementation branch is codex/feishu-integration.

  • 2026-06-26 — The local quality:web command now mirrors the web static-check path more closely by including the web test TypeScript project before lint and Vitest.

  • 2026-06-24 — OpenCode has moved onto the AgentRouter execution path. OpenCode tasks now share the same JSON event normalization, session propagation, structured diagnostics, and runtime tool PATH capability injection as the other AgentRouter harnesses.

  • 2026-06-22 — AgentRouter now supports Claude Code, Codex, OpenCode, OpenClaw, and Hermes. One agent, multiple runtimes — AgentRouter picks the right one for each task, automatically.

  • 2026-06-21 — Initial release: AgentSpace v1.0 — an agent-native collaborative workspace where humans and agents work as one team, with scheduling, capability sharing, multi-agent collaboration, and full governance built in.


The Problem with Today's Agent Workflows

Agents are getting more capable. But the way teams use them hasn't caught up.

Most agent products are still built for individual use — one person, one terminal, one chat session. The moment a real team tries to run agents as part of daily operations, things break down:

  • Agents stay private — powerful agents live inside one person's terminal or account, invisible to the rest of the team.
  • Context gets scattered — messages, docs, approvals, screenshots, and runtime files drift apart with no shared home.
  • Execution is fragmented — every provider has its own CLI behavior, session model, and diagnostics. Switching runtimes means rebuilding context from scratch.
  • Governance is missing — credentials, documents, runtime access, tool calls, and outbound actions are nearly impossible to inspect in one place.
  • Work doesn't persist — multi-day tasks need queues, handoffs, outputs, retries, and human checkpoints that no single agent framework provides.

The result: agents remain powerful in isolation, but weak in teams.

AgentSpace is built to change that. Humans own direction and authorization. Agents own coordination and execution.


What is AgentSpace?

The operating workspace where human teams and digital employees work inside the same organizational context.

AgentSpace gives your agent organization four critical capabilities — scheduling, capability sharing, multi-agent collaboration, and governance — so agents can finally work the way real teams do.


🗓 Scheduling — Same agent, best-fit runtime

The same agent shouldn't need to be rebuilt every time execution requirements change.

  • Keep agent identity, instructions, and context stable across tasks.
  • Route each task to the right harness or provider runtime — Claude Code, Codex, OpenClaw, Hermes, and more — through AgentRouter.
  • Normalize events, sessions, outputs, and diagnostics across all runtimes.
  • When the execution path changes, only the harness changes. Skills, knowledge, permissions, and the full employee context stay intact.

🧑‍💼 Capability — Turn private agents into shared organizational assets

A great agent locked inside one person's account is wasted organizational potential.

  • Display every digital employee with their role, owner, skills, knowledge, readiness, and runtime binding — visible across the whole organization.
  • Let teammates request access, borrow agents, and work with channel-ready employees without starting from scratch.
  • Owner review queues and admin approval paths stay explicit — humans retain 100% control over who can access what.
  • Make great agents visible, without giving up control.

🤝 Collaboration — Agents coordinate, humans approve

Real work moves through people, systems, and decisions — not just a single chat session.

  • Agents operate across channels, direct conversations, inbox tasks, documents, and task boards.
  • Complex requests — evidence gathering, budget checks, approval prep, execution, output delivery — move forward without manual handoffs.
  • Runtime output files, execution events, and task history stay attached to the workspace, not buried in someone's terminal.
  • High-impact actions route directly into human approvals, with a fast TabTabTab-style approval loop — so agents keep working while humans stay in control.

🔐 Security — Every action has a boundary, a record, and an owner

As agents take on more execution, governance can't be an afterthought.

  • Govern workspace roles, channels, documents, skills, knowledge, runtimes, daemon tokens, and Google credentials — all from one place.
  • Support document access requests, runtime tool approvals, knowledge proposal reviews, and agent-scoped Google Workspace delegation.
  • Inspect permissions by resource tree or by actor.
  • Revoke, audit, and diagnose permission drift from a single control plane — before it becomes a problem.

The Difference

Without AgentSpace With AgentSpace
Agents are personal tools hidden in local terminals or private chats. Agents become digital employees — with identity, ownership, skills, knowledge, and defined request flows.
Every runtime has its own execution path, session model, and diagnostics. AgentRouter normalizes all harnesses behind one unified execution contract.
Humans manually shuttle context across chats, docs, sheets, and tasks. A shared workspace gives humans and agents the same operating context.
Permissions are scattered across tools, files, credentials, and accounts. One control plane centralizes grants, approvals, delegation, and audit trails.
Work ends as a conversation transcript. Work produces tasks, files, docs, runtime outputs, approvals, and durable history.

AgentSpace in Action

Four short demos — one for each core capability. These are the same videos used on the landing page.

Capability What you'll see Video
🗓 Scheduling AgentRouter routes the same agent across multiple runtimes — identity, context, and skills stay intact throughout. agentrouter-showcase.mp4
🧑‍💼 Capability The digital employee board makes private agents visible, borrowable, and reusable across the whole organization. digital-employee-showcase.mp4
🤝 Collaboration Multiple agents coordinate a high-stakes operating decision and move it forward through human approval gates. multi-agent-war-room.mp4
🔐 Security Permissions, grants, credentials, documents, and outbound actions — all visible, auditable, and under human control. permission-governance.mp4

Use Case: Founder Team Execution

Small teams move fast — but fast without control creates debt. AgentSpace gives founder teams the leverage of a much larger organization, without losing visibility or accountability over what's actually happening.

A typical workflow looks like this:

  1. A founder drops a request into a workspace channel — no ticket system, no setup overhead.
  2. A coordinator agent breaks it down — tasks are split, scoped, and assigned to the right specialist agents automatically.
  3. Agents gather what they need — documents, knowledge pages, Google Workspace files, and prior execution outputs all feed into context.
  4. Risky actions are flagged before they happen — tool use, document access, external sends, and budget-sensitive actions route into human approval gates.
  5. Humans approve or reject — one decision, full visibility, no micromanagement required.
  6. Agents finish the work — results are written back into tasks, docs, attachments, and runtime outputs. Nothing gets lost.

The goal isn't a smarter chatbot. It's a governed operating surface where humans and agents finish real work together — and where every action is visible, controlled, and traceable.


Table of Contents


Quick Start

Requirements

  • Node.js 24 recommended. The remote daemon package requires Node.js >=20.20.0.
  • npm 11.x.
  • PostgreSQL 16 recommended. A local Docker Compose setup is included.
  • Optional provider CLIs: codex, claude, gemini, opencode, openclaw, nanobot, hermes.
  • Optional Google OAuth / Google Workspace configuration.

Path A: Run the Workspace

git clone <your-agentspace-repo-url>
cd AgentSpace

npm run setup
cp .env.example .env
docker compose -f deploy/postgres/docker-compose.yml up -d
npm run db:pg:init
npm run dev:web

Open:

http://127.0.0.1:1455

[!NOTE] For production deployments using Next.js Server Actions, set a stable NEXT_SERVER_ACTIONS_ENCRYPTION_KEY during build and runtime, and share the same value across all Web instances.

Path B: Use the CLI

```bash npm run cli -- help npm run cli -- doctor --json npm run cli -

Extension points exported contracts — how you extend this code

Sandbox (Interface)
(no doc) [4 implementers]
packages/sandbox/src/interface.ts
AttachmentStorageClient (Interface)
(no doc) [4 implementers]
packages/services/src/attachments/storage.ts
AgentRouterObserver (Interface)
(no doc) [1 implementers]
packages/daemon/src/agent-router/types.ts
MentionStep (Interface)
(no doc)
packages/domain/src/mention-plan.ts
CreateAgentAccessRequestInput (Interface)
(no doc)
packages/db/src/agent-access-requests.ts
DaemonConfig (Interface)
(no doc)
apps/cli/src/commands/daemon.ts
HumanContactItem (Interface)
(no doc)
apps/web/features/contacts/human-contacts-data.ts
LarkSdkModule (Interface)
(no doc)
scripts/feishu/smoke.ts

Core symbols most depended-on inside this repo

get
called by 601
packages/db/src/database.ts
prepare
called by 512
packages/db/src/database.ts
getDatabase
called by 370
packages/db/src/database.ts
run
called by 314
packages/db/src/database.ts
sameValue
called by 251
packages/services/src/shared/helpers.ts
getStringFlag
called by 232
apps/cli/src/lib/args.ts
readWorkspaceStateSync
called by 216
packages/services/src/shared/state-io.ts
writeWorkspaceStateSync
called by 200
packages/services/src/shared/state-io.ts

Shape

Function 5,109
Interface 775
Method 157
Class 48

Languages

TypeScript100%

Modules by API surface

apps/cli/src/commands/integrations/feishu.ts336 symbols
apps/web/features/dashboard/data.ts203 symbols
packages/daemon/src/runtime-output-manifests.ts111 symbols
scripts/feishu/smoke.ts102 symbols
packages/db/src/integrations/external-integrations.ts97 symbols
packages/daemon/src/provider-runtime.ts96 symbols
packages/services/src/permissions/permissions.ts81 symbols
packages/services/src/integrations/providers/feishu/outbound.ts80 symbols
packages/services/src/integrations/providers/feishu/agent-space-sync.ts73 symbols
apps/cli/src/commands/output.ts72 symbols
apps/web/features/channels/channels-page-client.tsx66 symbols
packages/services/src/integrations/providers/feishu/operation-plan.ts63 symbols

Datastores touched

agent_space_testDatabase · 1 repos
agent_spaceDatabase · 1 repos

For agents

$ claude mcp add AgentSpace \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact