Local daemon for Blast activity tracking. Caches activity data in SQLite and syncs to the Blast server every 10 minutes (with exponential backoff on failures).

go install github.com/taigrr/blastd@latest

blastd is automatically started by the blast.nvim plugin, so running it manually is optional. Note, that if blastd hasn't received any data for a while, it will also automatically stop itself to save resources, and will be restarted by blast.nvim when you start coding again.

Create ~/.config/blastd/config.toml:

# Blast server URL
server_url = "https://nvimblast.com"

# API token from nvimblast.com/dashboard
auth_token = "blast_xxxxx"

# Sync interval in minutes (default: 10)
sync_interval_minutes = 10

# Machine identifier (default: hostname)
machine = "macbook-pro"

# Metrics-only mode — sends "private" for project name and git remote
# Useful if you want time/filetype/APM stats without revealing what you work on
# metrics_only = true

All config fields can also be set via environment variables with the BLAST_ prefix:

Config file values take precedence over env vars, which take precedence over defaults.

blastd
blastd --version
blastd --help

Project names are never shown publicly, but they are sent to the Blast server so you can see a per-project breakdown on your own profile. If you'd rather not share project names at all — whether it's a secret project or just a preference — there are two ways to opt out:

Create a .blast.toml anywhere between a file and its git root:

# Override the project name (default: git directory name)
name = "my-project"

# Mark as private — activity is still synced, but project name and git remote
# are replaced with "private" so the server only sees time, filetype, and metrics
private = true

The editor plugin (e.g. blast.nvim) walks up from the current file to the git root, using the closest .blast.toml it finds. This supports monorepos — place .blast.toml in subdirectories to give them distinct names or mark specific folders as private.

Set metrics_only = true in config.toml or BLAST_METRICS_ONLY=true in your environment. This replaces all project names and git remotes with "private" at sync time, regardless of per-project .blast.toml settings. Useful if you want to track your coding habits without revealing any project information.

The daemon listens on a Unix socket at ~/.local/share/blastd/blastd.sock.

{
  "type": "activity",
  "data": {
    "project": "blast",
    "git_remote": "git@github.com:taigrr/blastd.git",
    "started_at": "2024-01-01T00:00:00Z",
    "ended_at": "2024-01-01T00:05:00Z",
    "filetype": "go",
    "lines_added": 10,
    "lines_removed": 5,
    "actions_per_minute": 45.5,
    "words_per_minute": 60.2
  }
}

{ "type": "ping" }

Trigger an immediate sync (rate-limited to 10 requests per 10-minute window):

{ "type": "sync" }

• blast.nvim - Neovim plugin (FOSS)