Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@nothumanwork/nn) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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