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