Show HN: Locus – Git‑aware CLI task manager using Markdown

3 points

a year ago

I built Locus after spending a lot of time collaborating with AI coding assistants. To get high-quality work from an agent you need a well-structured Markdown brief for every task, and if you run several agents in parallel you need a fast, local way to manage those files. GitHub Issues is conceptually close, but it lives in the cloud and is awkward to drive from a CLI that an agent can call. So I wrote Locus: a Git-native, local-first CLI task manager where each task lives in its own Markdown file that an AI assistant can read and write.

What it is Locus stores each task as a Markdown file with YAML front matter, auto‑organized by repository at ~/locus/<user>/<repo>/. No server or DB—just plain files you can edit in VS Code, Obsidian, or any Markdown editor.

Key features – Git‑aware, offline‑first directory layout – Tags / status / priority managed from the CLI – JSON output for scripting or LLMs

Quick try (Deno)

    deno install -q -A -n locus jsr:@tesso/locus
    locus add "Write Show HN post" --tags writing,show-hn
    locus list --detail

Feedback and PRs welcome!