Skip to main content

Transcribe Your Voice In Terminal. 100% Local.

hns is a speech-to-text CLI tool to transcribe your voice from your microphone directly to clipboard. Integrate hns with Claude Code, Ollama, LLM, and more CLI tools for powerful workflows.

$uv tool install hns
Command line examples showing hns in action

Loved by developers

Hacker News testimonial praising hns for its simplicity and effectiveness

Why hns?

No Subscription

Runs on consumer-grade hardware.

No need to send your data to cloud and pay recurring fee for something you can run on your own device.

Terminal Native

CLI tool built for developers.

Follows the unix philosophy of doing one thing well. Suitable for integrating with your other favorite CLI tools and workflows.

Control Your Data

Your data stays locally on your machine.

Your sensitive informations and private thoughts are not being harvested for model training or advertisement and not being shared with third parties.

Capture thoughts at the speed of speech. Ship faster.

Get Started In 30 Seconds

What could you do with hns?

Drive AI Coding Agents

Provide detailed, context-rich prompts to coding agents like Claude Code, Codex CLI, or Cursor CLI without typing. Speaking your instructions is faster and more comprehensive.

Send instructions to Claude Code with your voice
claude "$(hns)"

Effortless Daily Journaling

Overcome the "blank page" problem by speaking your thoughts freely. A simple command can append your raw transcription to a daily note, or pipe it through an LLM to structure it.

Append raw transcription to a dated journal file
hns >> "~/obsidian-vault/$(date '+%Y-%m-%d').md"

Turn Your Voice Into Polished Text

Spoken language is messy. Pipe your raw `hns` transcription through a local or remote LLM to instantly fix grammar, remove filler words, and produce clean, professional text.

Clean up transcription using a local LLM
ollama run gemma3:1b \
  "Fix grammar and punctuation. Output only corrected text. \
  Text: $(hns)"

Translate Your Voice

Dictate in English and get a translation in polite Japanese. Perfect for communicating with teams across the world without leaving your terminal.

Translate to polite Japanese
llm -- model gpt-4.1-nano \
  --system "Translate into polite natural Japanese. Output only translation." \
  "$(hns)"

Integrate hns with your favorite CLI tools. Create powerful workflows.

Dive Into Use Cases