AgentDrive

sh.agentdrive由 agentdrive.sh 发布官方发布者v1.0.0更新于 Nov 2, 2026

Cross-agent artifact workspace with provenance across Claude Code, Codex, Cursor, LangGraph.

已验证Streamable HTTP可网页运行效率与工作流文件与存储知识与记忆

概览

AI 生成的概览

AgentDrive 为助手提供跨工具的共享 Markdown 工作区，支持版本管理、语义召回、会话交接与运行溯源。

可以做什么
  • 在工作区中写入、读取、列出、删除 Markdown 文件并查看版本历史
  • 对组织内产物做语义搜索、召回持久事实，并自动拉取相关历史上下文
  • 列出项目过往的智能体会话，加载交接摘要以继续其他工具中的工作
  • 生成分享链接、给文件添加评论、读取人工反馈与工作区动态
  • 按邮箱邀请成员、管理各工作区角色，并查看组织、套餐与用量信息
  • 记录智能体运行以供溯源，并在 Linux 沙箱中克隆仓库、执行命令、读取文件与提交（实验性）
适用场景
适合同一项工作在 Claude Code、Codex、Cursor、Gemini CLI 等工具之间切换、每次换会话或换工具就丢失上下文的场景。也适合需要共享产物、人工评论审阅以及记录哪个智能体产出什么内容的团队。
运行要求
可使用远程 Streamable HTTP 端点，或通过 npx 在本地运行 npm 包（需 Node.js）。需要 AgentDrive API 密钥，以 Authorization Bearer 令牌或 AGENTDRIVE_API_KEY 提供，可免费获取。可选变量用于设置 API 地址、智能体平台与角色。沙箱工具需 AgentDrive worker 启用 Cloudflare Containers。
安装前请注意
API 密钥属于机密，可访问组织工作区，请勿写入共享配置。多个工具会改动共享状态：写入、删除、分享文件，按邮箱邀请成员，调整工作区角色，以及提交沙箱工作。沙箱工具会执行 shell 命令并克隆仓库。工作区内容、评论与运行日志会存储在 AgentDrive 的托管服务上。

安装

在 SourceWeft 中

  1. 打开 控制台中的 AgentDrive，将其添加到工作区。
  2. 连接 Authorization token 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/sh.agentdrive%2Fagentdrive/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "agentdrive": {
      "type": "http",
      "url": "https://mcp.agentdrive.sh/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

AgentDrive MCP Server

The official Model Context Protocol server for AgentDrive — a cross-agent artifact workspace with provenance and portable storage across Claude Code, Codex, Cursor, LangGraph, and any MCP-aware host.

Give your agents a shared, persistent workspace: files with versioning, semantic recall over everything prior agents produced, run logging, and cross-agent attribution — so the next session (on any tool) picks up where the last one left off.

Claude Code plugin

This repo is also the Claude Code plugin marketplace. The plugin captures every session in the background and resumes it from Codex, OpenCode, Gemini CLI, Antigravity, or Cursor:

/plugin install agentdrive --marketplace Rakesh1002/agentdrive-mcp

On Claude Code older than 2.1.275, run /plugin marketplace add Rakesh1002/agentdrive-mcp then /plugin install agentdrive@agentdrive. Sign in with /agentdrive:login.

Get an API key (free)

Create one at https://app.agentdrive.sh — no credit card. The free tier (1 workspace, 1 GB storage, 10k embeddings) is free indefinitely.

Two ways to connect

1. Hosted (no install) — Streamable HTTP

Point any MCP client that supports remote servers at the hosted endpoint and pass your key as a bearer token:

URL:    https://mcp.agentdrive.sh/mcpHeader: Authorization: Bearer agentdrive_live_xxx

Or install in one click via Smithery.

2. Local (stdio) — via npx

jsonc
{  "mcpServers": {    "agentdrive": {      "command": "npx",      "args": ["-y", "@adrive/mcp-server"],      "env": {        "AGENTDRIVE_API_KEY": "agentdrive_live_xxx"      }    }  }}

Add that block to your host's MCP config:

  • Claude Desktop: claude_desktop_config.json
  • Cursor: ~/.cursor/mcp.json
  • Claude Code: install the plugin (see above), which also captures sessions
  • Codex / Cline / Continue / Zed: the standard mcpServers block above

The fastest path is the AgentDrive installer, which auto-wires every detected host:

sh
curl -fsSL agentdrive.sh/install | sh

Configuration

Env varRequiredDefaultDescription
AGENTDRIVE_API_KEYnokey saved by adrive auth loginYour AgentDrive API key (agentdrive_live_...). Falls back to ~/.config/agentdrive/config.json, so client configs never need the key inline. With no key at all the server still starts and offers one tool, drive_connect, which signs the user in through the browser and connects their other agent tools; the full toolset then appears in the same session.
AGENTDRIVE_API_URLnohttps://app.agentdrive.shOverride the API endpoint (self-hosted worker).
AGENTDRIVE_AGENT_PLATFORMnounknownWhich agent runtime is calling — drives cross-agent provenance. One of claude-code, codex, opencode, gemini-cli, cursor, antigravity, langgraph, crewai, autogen, hermes, openclaw, unknown.
AGENTDRIVE_AGENT_ROLEno—Free-text role label (e.g. planner, reviewer) to distinguish multiple agents on the same platform.

Tools

22 tools across files, memory, sessions, collaboration, org, and provenance. The stdio server derives the current project from its working directory (git remote, else repo path), which scopes drive_sessions and drive_resume.

ToolCategoryDescription
drive_contextmemoryAuto-pull the most relevant prior artifacts for the task you're starting.
drive_searchmemorySemantic search across your org's artifacts.
drive_recallmemoryRecall persistent facts/preferences agents have written.
drive_sessionssessionsList recent agent sessions for this project across Claude Code, Codex, OpenCode, Gemini CLI, Antigravity, and Cursor.
drive_resumesessionsLoad a compact handoff (goal, files touched, recent turns) from a prior session, by default the latest from a different harness.
drive_writefilesWrite a markdown file (auto-versioned).
drive_readfilesRead a file's content.
drive_listfilesList files in a workspace.
drive_deletefilesDelete a file.
drive_versionsfilesView a file's version history.
drive_sharecollaborationGenerate a (optionally email-gated) share link.
drive_commentcollaborationComment on a file.
drive_feedbackcollaborationRead human comments on a file.
drive_activityprovenanceRecent workspace activity (writes, comments, shares).
drive_log_runprovenanceLog an agent run (task, status, artifacts, identity).
drive_inviteorgInvite a human to your org by email.
drive_rolesorgAssign/list/remove per-workspace access by email.
drive_orgorgView org details: agents, members, plan, usage.
drive_sandbox_clonesandbox (experimental)Clone a git repo into a per-workspace Linux sandbox.
drive_sandbox_execsandbox (experimental)Run a shell command in the sandbox.
drive_sandbox_readsandbox (experimental)Read a file from the sandbox filesystem.
drive_sandbox_commitsandbox (experimental)Stage + commit the sandbox worktree.

The drive_sandbox_* tools require the Cloudflare Containers plan on the AgentDrive worker and degrade cleanly to a "not configured" message otherwise.

Why AgentDrive

Agents lose context at every session boundary and every tool switch. AgentDrive is the shared substrate: one workspace, every agent, full provenance. Write once with Claude Code; recall it from Cursor; hand off to Codex — each call is attributed to the right principal and platform.

Develop

sh
npm installnpm run build      # tsc -> dist/npm test           # vitest

License

Apache-2.0. See LICENSE.

来源：README.md，提交 b2a451a

工具

22

drive_write

Write a markdown file to a workspace. Creates or updates the file with automatic versioning.

输入参数path必填content必填messageworkspace_id必填

drive_read

Read a file's content from a workspace.

输入参数file_id必填workspace_id必填

drive_list

List files in a workspace, optionally filtered by path prefix.

输入参数prefixworkspace_id必填

drive_share

Generate a share link for a workspace or specific file. Optionally email-gate the link so only a specific person can access it. Humans open this link to view, comment, or edit files.

输入参数emailfile_idmax_usesexpires_inpermission必填workspace_id必填

drive_comment

Add a comment to a file.

输入参数body必填file_id必填line_endline_startworkspace_id必填

drive_feedback

Read human comments on a file. Use this to check if humans have left feedback.

输入参数file_id必填workspace_id必填

drive_activity

Get recent activity in a workspace (file writes, comments, shares).

输入参数workspace_id必填

drive_invite

Invite a human to your organization by email. They will receive a verification code to join.

输入参数roleemail必填

drive_roles

Manage per-workspace role delegation. Assign, list, or remove access for specific emails (view/comment/edit).

输入参数emailaction必填permissionworkspace_id必填

drive_org

View your organization details: agents, members, plan, and usage.

无需输入参数。

drive_delete

Delete a file from a workspace.

输入参数file_id必填workspace_id必填

drive_versions

View version history for a file in a workspace.

输入参数file_id必填workspace_id必填

drive_recall

Recall persistent facts and preferences your agents have written. In v1 this returns semantic search results across artifacts; v1.5 will narrow to auto-extracted facts (preferences, decisions, key entities).

输入参数query必填top_k

drive_log_run

Log an agent run to AgentDrive's provenance store. Captures task, status, referenced/produced artifacts, and cross-platform identity (which agent on which tool). Used for retrospective context retrieval and team-wide audit.

输入参数task必填run_idstatusmetadataduration_msartifacts_producedartifacts_referenced

drive_context

Auto-pull the most relevant artifacts from prior agent sessions for the task you are about to do. Combines semantic relevance with recency. Call this at the START of any non-trivial task to ground the agent in prior context — replaces manual copy-paste of artifacts between sessions.

输入参数task必填limitworkspace_id

drive_sessions

List recent agent sessions for this project across harnesses (Claude Code, Codex, OpenCode, Gemini CLI, Cursor), newest first. Use to find prior work to continue.

输入参数limitprojectplatform

drive_resume

Load a compact handoff brief (goal, files touched, recent turns) from a prior session, by default the latest one from a different harness, so you can continue that work.

输入参数platformmax_charssession_id

drive_sandbox_clone

[EXPERIMENTAL] Clone a git repo into a per-workspace Linux sandbox. Requires Cloudflare Containers on the AgentDrive worker; gracefully degrades to a 503 with "sandbox not configured" otherwise.

输入参数url必填depthbranchworkspace_id必填

drive_sandbox_exec

[EXPERIMENTAL] Run a shell command inside the per-workspace Linux sandbox. Captures stdout/stderr (64 KB cap), exit code, duration. Requires Cloudflare Containers; degrades to 503 otherwise.

输入参数cmd必填cwdtimeout_msworkspace_id必填

drive_sandbox_read

[EXPERIMENTAL] Read a file from the per-workspace sandbox filesystem (build artifacts, test output, logs). Requires Cloudflare Containers; degrades to 503 otherwise.

输入参数path必填workspace_id必填

drive_sandbox_commit

[EXPERIMENTAL] Stage + commit the current sandbox worktree. Surfaces as an AgentDrive artifact at commits/<sha>.json. Requires Cloudflare Containers; degrades to 503 otherwise.

输入参数message必填author_nameauthor_emailworkspace_id必填

版本历史

1
  1. v1.0.0最新Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Agentdrive 集成

Reposcout

由 GitHub 账号 Rakesh1002 发布

Reposcout 是一个本地 MCP 服务器，让助手按既定目标发现、补充信息并对 GitHub 仓库进行加权、基于证据的排序。

STDIO仅桌面
开发者工具尚未验证Oct 25, 2026

Namemyapp

由 GitHub 账号 Rakesh1002 发布

namemy.app 的服务器，让助手生成可注册的品牌名称、查询域名实时可用性与价格，并提供一键购买链接或直接购买域名。

Streamable HTTP可网页运行鉴权
开发者工具14 个工具Nov 4, 2026