Listspace

app.listspacev2.0.0更新於 Oct 8, 2026

Project memory for AI agents: read and keep the user's Listspace boards up to date.

已驗證Streamable HTTP可網頁執行Developer ToolsProductivity & Workflow

概覽

AI 產生的概覽

讓 AI 助理讀取並更新使用者的 Listspace 看板，作為編碼工作的專案記憶。

功能
Listspace 是遠端 MCP 伺服器，把使用者的 Listspace 看板開放給助理，讓看板可以當作專案記憶。README 也介紹了搭配的技能與基於同一 REST API 的 Node CLI，指令包括 login、whoami、session、add 和 attach。CLI 可以新增項目並從磁碟附加檔案，所有指令都支援 JSON 輸出。
適用情境
當編碼助理需要在工作時同步更新 Listspace 看板，或讀取看板取得脈絡時使用。適合已經用 Listspace 看板做專案追蹤的團隊。
執行需求
遠端端點 mcp.listspace.app；清單未宣告任何套件、環境變數或標頭。README 說明可透過 MCP 用戶端進行 OAuth 登入，CLI 則使用 Listspace 設定 > API 的個人權杖。CLI 需要 Node 20 或更新版本；LISTSPACE_TOKEN 與 LISTSPACE_API_URL 是選用的覆寫項。
安裝前請注意
CLI 會把個人權杖保存在作業系統設定目錄的 credentials.json 中，LISTSPACE_TOKEN 可覆寫它。伺服器可以寫入看板，新增項目與附加檔案，因此變更應經過檢查。README 指出外掛刻意不附帶權杖標頭，因為權杖會發送給每位使用者。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Listspace，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "listspace": {
      "type": "http",
      "url": "https://mcp.listspace.app"
    }
  }
}

README

Listspace for coding agents

The pieces that let an agent use a Listspace board as its project memory. This folder is public as github.com/listspace/agent, and the CLI is on npm as listspace. Install and sign in with:

bash
npx listspace login     # paste a personal token from Listspace: Settings > APInpx listspace boards
PathWhat it is
skills/listspace/The skill: SKILL.md (the work loop) plus reference/ (tools, freedom levels, CLI), loaded only when needed. Follows the Agent Skills format, so npx skills add can install it. This is the source copy.
cli/listspace, a small Node CLI over the REST API (https://api.listspace.app/v1) for agents without the MCP server. TypeScript bundled into one ESM file, no runtime dependencies, Node 20 or later.
claude-code-plugin/A Claude Code plugin: the skill (a copied file set) and .mcp.json, which registers the remote MCP server https://mcp.listspace.app.
.claude-plugin/marketplace.jsonA marketplace file listing the plugin, so this folder can be added as a local marketplace now and as a GitHub one later.
AGENTS.md.snippetLines a user pastes into a repo's AGENTS.md or CLAUDE.md to point agents at their board.
scripts/sync-skill.mjs copies the skill into the plugin; check-agent.mjs (in CI) checks the copy, the frontmatter, the versions and the MCP entry.

The MCP server is also listed in the MCP Registry as app.listspace/listspace and on Smithery.

Editing the skill

Edit skills/listspace/ only, then run:

bash
node agent/scripts/sync-skill.mjsnode agent/scripts/check-agent.mjs

The plugin gets a real copy, not a symlink, so the plugin folder still works when it is copied or downloaded on its own. CI fails when the two differ. Keep SKILL.md short: steps and rules there, detail in reference/.

One version runs through cli/package.json, cli/src/version.ts, plugin.json and the skill's metadata.version; the check fails when they differ.

Try it locally

The CLI

bash
cd agent/clinpm cinpm run buildnode dist/listspace.mjs login            # paste a token from Listspace: Settings > APInode dist/listspace.mjs whoaminode dist/listspace.mjs session "<board title or id>"node dist/listspace.mjs add "<board>" ideas "Try dark mode" --description "Seen in **settings**"

npm link in agent/cli puts listspace on the PATH. LISTSPACE_TOKEN overrides the saved token for one run, and LISTSPACE_API_URL points the CLI at another server. Every command takes --json. The token is saved in the OS config directory (%APPDATA%\listspace on Windows, ~/Library/Application Support/listspace on macOS, ~/.config/listspace elsewhere) as credentials.json, mode 600.

Tests: npm test (node:test with a fake fetch, no network). npm run typecheck runs the strict type check.

The skill on its own

Any agent that reads Agent Skills:

bash
npx skills add ./agent -s listspace     # the skills CLI reads skills/ in a local folder

or copy agent/skills/listspace to ~/.claude/skills/listspace for Claude Code. Connect the MCP server separately (claude mcp add --transport http listspace https://mcp.listspace.app), or use the CLI above.

The Claude Code plugin

For one session:

bash
claude --plugin-dir ./agent/claude-code-plugin

Or as a local marketplace, which keeps it installed:

bash
claude plugin marketplace add ./agentclaude plugin install listspace@listspace

Then run /mcp, pick the listspace server and sign in (OAuth through Listspace). The skill shows up as /listspace:listspace and Claude loads it on its own when the project has a board. claude plugin validate ./agent/claude-code-plugin checks the manifest.

If you already added the Listspace MCP server yourself, Claude Code may show both; remove one.

What is left out, and why

  • comment: the API has it (POST /v1/items/:id/comments, MCP add_comment), but the CLI does not yet. Agents on the CLI log progress in a Project info item (the skill says so). attach is in the CLI since 0.2.0, because a file on disk is the one thing an agent cannot send reliably through MCP.
  • Device pairing for login: comes with sign-up (PR 9). login already separates "how the token is obtained" from saving it; a TODO in cli/src/cli.ts marks where pairing goes. --token and a piped token stay for scripts.
  • A token in the plugin: .mcp.json has no headers on purpose. A token would ship to every user; sign-in through /mcp is per user. The check script refuses headers there.
  • The CLI inside the plugin (bin/): left out, because claude.ai and Cowork do not install plugins with a top-level bin/ and the MCP server covers Claude Code.

Publishing

  1. Skill via npx skills add: published. The public repository listspace/agent holds this folder at its root, so npx skills add listspace/agent works.
  2. CLI on npm: published as the unscoped listspace (0.1.0). To release a new version: bump the one version (see "Editing the skill"), check the package contents with npm pack --dry-run, then npm publish from agent/cli with an npm account with 2FA. prepublishOnly runs the type check, tests and build.
  3. Claude Code plugin: the public repo doubles as a marketplace (.claude-plugin/marketplace.json), so users run /plugin marketplace add listspace/agent and /plugin install listspace@listspace. Listing in Anthropic's plugin directory is a separate submission; the owner decides on it, with privacy policy and terms URLs for that listing.

Sources: Claude Code plugin manifest reference (https://code.claude.com/docs/en/plugins-reference), plugin loading and --plugin-dir (https://code.claude.com/docs/en/plugins/loading), marketplace reference (https://code.claude.com/docs/en/plugins/marketplace-reference), skills (https://code.claude.com/docs/en/skills), Agent Skills specification (https://agentskills.io/specification), the skills CLI (https://github.com/vercel-labs/skills), and Postiz's agent repo as the model (https://github.com/gitroomhq/postiz-agent).

來源：README.md，提交 c98198a

工具

0
工具後設資料尚未被收錄。

版本歷史

1
  1. v2.0.0最新Oct 8, 2026