nn

Neural Net — multi-provider transcript fabric for AI coding agents.

Ingest, search, export, and sync conversation transcripts across Cursor, Claude Code, Codex, Pi, Grok, Antigravity, and more.

Install

npx @nothumanwork/nn --help

Or install globally:

npm install -g @nothumanwork/nn
nn --help

Quick start

# Install hooks for all supported providers (project-local)
nn install hooks

# Install hooks globally
nn install hooks --global

# Ingest transcripts from a provider
nn ingest --provider cursor --all

# Search normalized events
nn search "turso sync"

# List sessions
nn sessions list

# Export a session (stdout by default)
nn export --session <id>

# Check local DB and sync health
nn doctor

Commands

| Command | Description | | --- | --- | | nn install hooks [--global] [--provider <id>] | Install agent hooks | | nn hook --provider <id> --event <kind> | Hook entrypoint (used by agents) | | nn ingest --provider <id> [--session <id>] [--all] | Ingest provider transcripts | | nn export --session <id> [--to <target>] [--output <file>] | Export a session | | nn search <query> [--limit <n>] | Search transcript events | | nn sessions list [--provider <id>] | List ingested sessions | | nn sync status\|push\|pull | Turso embedded-replica sync | | nn doctor | Validate DB, hooks, and sync setup |

Configuration

Local state lives in .nn/state/ (override with NN_STATE_DIR or NN_DB_PATH).

Turso sync is optional — set TURSO_DATABASE_URL and TURSO_AUTH_TOKEN to enable cloud sync.

Development

This package ships prebuilt Bun-compiled binaries per platform. To build from source:

bun install
bun run build          # host platform only
bun run build:all      # all publish targets
bun test

License

MIT