voxn 0.3.1

Local voice note-taking suite

voxn

voxn is a local-first note and memory CLI for Linux. It captures voice or text notes, stores them as Markdown under ~/.local/share/voxn/, indexes them into SQLite FTS5, and exposes search, context, browse, ingest, and digest commands.

The default LLM path uses local Ollama. Remote OpenAI-compatible providers are optional; storage remains local.

Install

For a Python-only install:

pipx install 'voxn[whisper]'
# or
pip install 'voxn[whisper]'

For the full voice workflow, install system tools separately:

# Arch example
sudo pacman -S sox fzf sqlite wl-clipboard libnotify poppler
sudo pacman -S ollama    # or ollama-rocm

Then start Ollama and pull a model:

systemctl enable --now ollama
ollama pull gemma3:12b
voxn doctor

Quick Start

voxn add -p my-project "Capture this decision"
voxn doctor
voxn index --rebuild
voxn search -p my-project "decision"
voxn context -p my-project

Voice capture uses the bare command as a toggle:

voxn          # start recording
voxn          # stop, transcribe, format, and save

Main Commands

• voxn add: save direct text or stdin as a structured note.
• voxn ingest: summarize a file, URL, PDF, video, or stdin into notes.
• voxn index: rebuild the SQLite search index from Markdown notes.
• voxn remove: remove one indexed note from Markdown and SQLite.
• voxn search: search indexed notes by text, project, category, tag, or date.
• voxn context: emit a prompt-ready project memory block for agents.
• voxn browse: browse notes or generated wiki pages interactively with fzf.
• voxn digest: generate local wiki pages from notes.
• voxn doctor: check dependencies and bootstrap configured data paths.

Configuration

Default local paths:

• Notes: ~/.local/share/voxn/voxns.md
• SQLite DB: ~/.local/share/voxn/notes.db
• Wiki output: ~/.local/share/voxn/wiki/

voxn doctor creates those paths and initializes the DB when they are missing.

Configuration is read from ${XDG_CONFIG_HOME:-~/.config}/voxn/config.toml when present, then overridden by environment variables. Common environment variables:

• VOXN_CONFIG_FILE
• VOXN_NOTES_FILE
• VOXN_DB
• VOXN_DIGEST_DIR
• VOXN_LLM_PROVIDER
• VOXN_LLM_MODEL
• VOXN_LLM_BASE_URL

More Documentation

The repository README contains the full install guide, systemd user units, AUR packaging notes, architecture details, and contributor documentation:

https://github.com/okrinoggen33/voxn