
用于 Tana 集成的 CLI - 查询、创建、同步和管理 Tana 工作区,使用语义搜索和 MCP 服务器
概览
:通过命令行查询、编写、搜索并自动化您的Tana工作区。 Tana 已正式发布本地 API 和 MCP 服务器,Supertag CLI 现已完全集成。这意味着 Supertag-CLI 不再局限于只读导出和基础节点创建——你现在可以直接从命令行或任何兼容 MCP 的 AI 工具完成。新的 delta-sync 功能利用本地 API 只获取自上次同步以来发生变化的节点,使增量更新快速,无需完全重新导出。你只需要启用本地 API 的 Tana Desktop 运行即可。Supertag CLI 会自动检测本地 API,并在 Tana Desktop 不可用时退回 Input API,因此你的现有工作流程保持不变。 : GitHub 版本(macOS ARM64/Intel,Linux x64,Windows x64) 查看带有逐步截图的视觉入门指南。
概述(AI 翻译)
完整Tana集成:通过命令行查询、编写、搜索并自动化你的Tana工作区。
v2.0.0 新增内容
Tana 已正式发布本地 API 和 MCP 服务器,Supertag CLI 现已完全集成。这意味着 Supertag-CLI 不再局限于只读导出和基础节点创建——你现在可以编辑节点、管理标签、设置字段值、勾选任务和丢弃节点,这些操作可以直接从命令行或任何兼容 MCP 的 AI 工具完成。新的 delta-sync 功能利用本地 API 只抓取自上次同步以来发生变化的节点,使增量更新快速,无需完全重新导出。你只需要启用本地 API 的 Tana Desktop 运行即可。Supertag CLI 会自动检测本地 API,并在 Tana Desktop 不可用时回退到 Input API,因此你的现有工作流程保持不变。
三工具架构
| 工具 | 尺寸 | 用途 |
|---|---|---|
supertag |
~57 MB | 主CLI - 查询、写入、同步、服务器 |
supertag-export |
~59 MB | 导出浏览器自动化 |
supertag-mcp |
~60 MB | 用于AI工具集成的MCP服务器 |
本页由 AI 翻译,技术细节请以原文为准。
README
以下为原文 README 节选,完整内容请查看原文。
Supertag CLI
Complete Tana integration: Query, write, search, and automate your Tana workspace from the command line.
What’s New in v2.0.0
Tana has officially released their Local API and MCP server, and Supertag CLI now fully integrates with it. This means supertag-cli is no longer limited to read-only exports and basic node creation — you can now edit nodes, manage tags, set field values, check off tasks, and trash nodes directly from the command line or through any MCP-compatible AI tool. The new delta-sync feature uses the Local API to fetch only changed nodes since your last sync, making incremental updates fast without needing a full re-export. All you need is Tana Desktop running with the Local API enabled. Supertag CLI auto-detects the Local API and falls back to the Input API when Tana Desktop isn’t available, so your existing workflows keep working unchanged.
Three-Tool Architecture
| Tool | Size | Purpose |
|---|---|---|
supertag |
~57 MB | Main CLI - query, write, sync, server |
supertag-export |
~59 MB | Browser automation for exports |
supertag-mcp |
~60 MB | MCP server for AI tool integration |
Downloads: GitHub Releases (macOS ARM64/Intel, Linux x64, Windows x64)
New to Supertag? Check out the Visual Getting Started Guide with step-by-step screenshots.
Learn more: Video Course | Discord Community
Table of Contents
- Quick Start
- Capabilities
- READ - Query Workspace
- WRITE - Create Nodes
- MUTATE - Edit Existing Nodes
- QUERY - Unified Query Language
- GQUERY - Graph Query DSL
- BATCH - Multi-Node Operations
- AGGREGATE - Group and Count
- TIMELINE - Time-Based Queries
- RELATED - Graph Traversal
- WATCH - Continuous Monitoring
- EXPORT - Automated Backup
- EMBED - Semantic Search
- TABLE - Bulk Field Export
- CONTEXT - AI Context Assembly
- RESOLVE - Entity Resolution
安装
npx playwright install chromium配置
{
"mcpServers": {
"tana": { "command": "/path/to/supertag-mcp" }
}
}