Drive a live nanoTracker session (https://federatedindustrial.com/tracker) from any AI coding agent. Local relay + MCP server + CLI + adapter snippets for Claude Code, Cursor, Cline, Continue, Aider, Codex, Gemini CLI, opencode, openclaude.
<p align="center">
<img src="resources/icon.png" alt="nanoTracker API SDK" width="180">
</p>
<h1 align="center">nanoTracker API SDK</h1>
<p align="center">
<em>Drive a live nanoTracker session from any AI coding agent, CLI, or script — no DevTools, no browser flags, no PWA-breaking workarounds.</em>
</p>
<p align="center">
<a href="CHANGELOG.md"><img alt="Version" src="https://img.shields.io/badge/api-v1.0-ff7a00?style=flat-square&labelColor=140800"></a>
<a href="LICENSE"><img alt="License" src="https://img.shields.io/badge/license-MIT-blue?style=flat-square"></a>
<img alt="Node" src="https://img.shields.io/badge/Node-20%2B-3c873a?style=flat-square">
<img alt="Transport" src="https://img.shields.io/badge/transport-MCP%20%C2%B7%20HTTP%20%C2%B7%20CLI-7b61ff?style=flat-square">
<a href="AGENTS.md"><img alt="Agent-friendly" src="https://img.shields.io/badge/agents-Cursor%20%C2%B7%20Hermes%20%C2%B7%20Codex%20%C2%B7%20Cursor%20%C2%B7%20Cline%20%C2%B7%20Continue%20%C2%B7%20Aider%20%C2%B7%20Gemini%20%C2%B7%20opencode-c8a8ff?style=flat-square"></a>
</p>
---
## 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
<https://federatedindustrial.com/tracker>.
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`](https://github.com/savannah-i-g/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
│
Agent that generates comprehensive documentation, API references, architecture diagrams, and developer onboarding guides from existing code.
Agent configuration for systematic bug investigation that traces issues from error logs through the codebase to root cause with suggested fixes.
Agent for integrating third-party APIs including SDK setup, type generation, error handling, retry logic, and rate limit management.
Cursor's built-in autonomous coding agent that can make multi-file edits, run terminal commands, search the codebase, and iteratively build features with minimal human intervention.
Cloud-based autonomous coding agent that runs in the background on remote sandboxed environments, handling complex multi-step tasks while you continue working.
Cursor's multi-file editing agent within Composer mode that can create, edit, and delete files across your entire project in a single conversation.