savannah-i-g/nanotracker-api-sdk

nanoTracker API SDK

通过任何AI编码代理、CLI或脚本驱动实时nanoTracker会话——无需开发工具，无需浏览器标记，无需破坏PWA的变通方法。

---

这是什么

一个小型、MIT授权的线束，允许外部程序读取和 在浏览器标签页中编写实时 nanoTracker 项目 .

该跟踪器会暴露一个JavaScript API（window.nanoTracker），其中 对模式、采样、序列层和歌曲状态进行批量CRUD处理。 该SDK包含：

• 一个微小的本地中继，用于连接HTTP和浏览器标签页，
• 一个MCP服务器，使任何现代编码代理都能免费获得六个工具，
• 用于shell脚本和人类的CLI，
• 每个代理的技能包，镜像纳米追踪器 plugin-sdk 布局，
• 九种MCP识别编码工具的适配器摘要，
• 可运行的端到端示例。

页边的桥梁，用纳米追踪器关闭循环飞船 它本身;这个仓库就是一切。

---

5分钟快速启动

你需要Node 20+，一台最近的Chromium / Firefox / Safari，还有 nanoTracker标签页在 .

这就是整个循环。这个仓库里的其他东西都是细节。

---

选你的经纪人

下面的每个特工都会说MCP。

nanoTracker API SDK

Drive a live nanoTracker session from any AI coding agent, CLI, or script — no DevTools, no browser flags, no PWA-breaking workarounds.

---

What this is

A small, MIT-licensed harness that lets external programs read and write a live nanoTracker project running in a browser tab at .

The tracker exposes a JavaScript API (window.nanoTracker) with batched CRUD over patterns, samples, sequence layers, and song state. This SDK ships:

• a tiny local relay that bridges HTTP and the browser tab,
• an MCP server so any modern coding agent gets six tools for free,
• a CLI for shell scripts and humans,
• per-agent skill bundles mirroring the nanoTracker plugin-sdk layout,
• adapter snippets for nine MCP-aware coding tools,
• runnable end-to-end examples.

   you ──MCP / HTTP / CLI──>   relay (127.0.0.1:9311)   ──WS──>   nanoTracker tab
                                                              │
                                                              ↓
                                                window.nanoTracker

The page-side bridge that closes the loop ships with nanoTracker itself; this repo is the everything-else.

---

5-minute quickstart

You need Node 20+, a recent Chromium / Firefox / Safari, and a nanoTracker tab open at .

# 1. Clone + install
git clone https://github.com/savannah-i-g/nanotracker-api-sdk
cd nanotracker-api-sdk/tools
npm install

# 2. Start the relay
node relay.mjs
# → token written to ~/.nanotracker/relay-token, also printed to stderr

# 3. In the nanoTracker tab:
#    FILE > API…  →  Enable Local API
#                 →  Connect to local relay
#                 →  paste the token

# 4. Drive it
node ../tools/cli.mjs read getProjectSummary
node ../tools/cli.mjs execute '[{"op":"setBpm","value":140}]' '{"undoDescription":"first batch"}'

That’s the whole loop. Everything else in this repo is detail.

---