Documentation

Get started with Tuhnr in minutes.

Quick Start

1. Install the CLI

$ npm install -g tuhnr

Or use npx to run without installing: npx tuhnr --help

2. Import your conversations

$ tuhnr import

This scans for Claude Code sessions and imports them into your local database as cognitive commits.

3. Browse locally

$ tuhnr dashboard

Opens the local dashboard in your browser at localhost:4747

4. Sync to cloud (optional)

$ tuhnr login

$ tuhnr push

Login with GitHub and push your commits to access them from anywhere.

CLI Commands

tuhnr import

Import Claude Code sessions from all projects

Options:

  • --clearClear existing commits before importing
  • --projectImport only current project
tuhnr dashboard

Launch the local web UI to browse your commits

Options:

  • --port <port>Port to run on (default: 4747)
tuhnr login

Authenticate with GitHub for cloud sync

tuhnr logout

Clear stored authentication tokens

tuhnr push

Push local commits to the cloud

Options:

  • -v, --verboseShow verbose output
  • --dry-runPreview what would be pushed
  • --forceRe-push all commits (resets sync status)
  • --retryRetry previously failed commits
tuhnr pull

Pull commits from the cloud

Options:

  • -v, --verboseShow verbose output
tuhnr stats

View commit statistics

Options:

  • --project <name>Filter by project
  • --jsonOutput as JSON
tuhnr search <query>

Search through your conversations

Options:

  • --project <name>Filter by project
  • --limit <n>Limit results (default: 20)
tuhnr export

Export commits to JSON or Markdown

Options:

  • -o, --output <file>Output file path
  • --format <type>json or markdown
  • --project <name>Filter by project

Free Tier Limits

Cloud sync has usage limits on the free tier:

250
commits
50 MB
storage

Local usage is unlimited. When pushing, only the most recent commits sync up to the limit.

Automatically filtered: Warmup sessions and empty commits don't count against your limit.

Configuration

Tuhnr stores its data in ~/.tuhnr/:

# Data storage

~/.tuhnr/global/data.db

# Authentication

~/.tuhnr/auth.json

# Machine ID

~/.tuhnr/machine-id

Environment Variables

For self-hosted Supabase instances, set these environment variables:

# Required for cloud sync

COGCOMMIT_SUPABASE_URL=your-url

COGCOMMIT_SUPABASE_ANON_KEY=your-key