A local command center for everything you build. A project dashboard you open in any browser, and the same page doubles as a live desktop wallpaper.
drashta (Sanskrit for "the one who sees") is a project and production dashboard that runs on your own machine. Point it at the folder where your projects live and it shows what is moving, what is stuck and what is running, with no accounts, no cloud and no setup per project.
It is a single Go binary with the web app built in. Start it, open a browser tab, done.
- A seismograph of your work. One lane per project for the last 7 or 30 days: file changes, commits, coding-assistant sessions, live servers and uncommitted work. Quiet projects fade out, busy ones stand out.
- Project pages. Open any project for its activity, files, commits, docs, running servers and sessions, with one-click Editor, Finder, Terminal and Open-in-browser buttons.
- A built-in tracker. Kanban board, milestones and timeline across projects. Tasks and notes are plain Markdown in
<project>/.drashta/, so they diff and version with your code. - An inbox for things waiting on your review.
- Search across projects, commits, docs and Claude Code sessions.
- File viewers for PDF, DWG drawings and 3D models, with a full-window mode.
- Git and Fossil history out of the box. Optional GitHub data through the
ghCLI. - Local and private. It binds to loopback only, and nothing leaves your machine.
![]() |
|
| Project page | Tracker |
drashta is a normal web page, so you can use it in a browser tab, as a wallpaper, or both at once. Three display modes, switched from the top bar:
| Mode | What it does |
|---|---|
| normal | The regular dashboard in a browser tab. |
| wallpaper | A quiet, read-only readout of your activity. Made to sit behind your windows. |
| browse | The same view on your desktop, but clickable, so you can jump straight into a project. |
Both tools below are optional; the dashboard works fully without them.
- macOS: Plash turns any web page into your desktop background. drashta ships a script and an optional Karabiner-Elements rule to switch modes with a key press. See
contrib/desktop/. - Windows (new, early): Lively Wallpaper can use a web page URL as your wallpaper. See
contrib/desktop/lively/README.md. The mode buttons and the Plash script are macOS-only there.
You need Go (version in go.mod) and Node.js (current LTS or newer; the web app is built once). Windows support is new and early, so expect rough edges.
macOS and Linux:
git clone https://github.com/Prath2000/drashta.git
cd drashta
npm --prefix web ci
npm --prefix web run build
go build -o drashta ./cmd/drashta
./drashtaWindows (PowerShell, same steps; the binary is drashta.exe):
git clone https://github.com/Prath2000/drashta.git
cd drashta
npm --prefix web ci
npm --prefix web run build
go build -o drashta.exe ./cmd/drashta
.\drashta.exeOpen http://127.0.0.1:4455.
./drashta -port 4467picks another port../drashta -versionprints the version../drashta -reindexrebuilds the cache and exits.- The
maketargets are macOS-only. On Windows use the plain commands above (and see the Lively guide to start it at login). make installcopies the binary to/opt/homebrew/bin, andmake serviceinstalls a launchd agent so drashta starts at login. Both change your machine, so read theMakefilefirst.
Nothing assumes a folder layout. On first start drashta finds your projects folder and writes ~/.drashta/config.toml. Edit it and restart.
projects_dir = "~/code" # where your projects live (default ~/projects)
roots = ["work", "personal"] # group folders inside projects_dir; each folder in a group is a project
hidden = ["old-experiments"] # hide from the UI (folder name, group/folder, or project id)
editor = "code -g {path}:{line}" # command behind "open in editor"
terminal = "Terminal" # app behind "open in terminal"
gh_enabled = true # allow calls to the gh CLI for GitHub dataAll settings
projects_dir: the folder that holds your projects.roots: group folders insideprojects_dir. When unset, they are discovered from the disk.hidden: project folders to hide. They are still found, so you can show them again.skip: extra folder names the file-tree walk will not enter.editor: the command that opens a file.{path}and{line}are filled in. Onlyconfig.tomlcan set it, never the API.terminal: the terminal app used to open a project.claude_profiles: Claude Code profile folders that holdprojects/<folder>/*.jsonlsessions. Found automatically when unset.gh_enabled: allow calls to theghCLI. Withoutgh, GitHub panels stay empty.desktop_script: optional script behind the mode buttons. Empty means off. It must be insideprojects_dir.chitralipi: path of the DWG reader program.
Set DRASHTA_HOME to use another data folder instead of ~/.drashta (useful for trying it out or for tests).
- macOS and Windows are supported. Windows support is new and early. Linux builds but is untested.
- Running dev servers are found with
lsofon macOS (it ships with macOS). Windows needs nothing extra: it uses the built-innetstat. - Optional:
gitfor history and activity.gh(GitHub CLI) for GitHub data.chitralipi, a DWG reader. Without it, a DWG file offers "Open in default app" instead of a preview.
~/.drashta/holds the SQLite index (index.db),config.tomland logs.<project>/.drashta/*.mdholds per-project tasks and notes. These files are the source of truth.- The index is a cache plus a history log.
-reindexrebuilds most of it, but the activity and server-run history cannot be rebuilt, so keep them if you want that history.
- Everything stays on your machine. The one exception is the optional
ghCLI, which talks to GitHub the way it normally does. Setgh_enabled = falseto avoid that. - drashta reads Claude Code session transcripts (
~/.claude*/projects/*/*.jsonl) for the sessions view. Known secret patterns are redacted before text reaches the index, search or the API. Redaction is pattern based, so treat~/.drashta/index.dbas sensitive. - The server binds to loopback and checks
Host,OriginandSec-Fetch-Siteon requests. Every mutating call needs a per-page token. This keeps other web pages in your browser from talking to it. - Anything that runs a command goes through a no-shell runner with path checks.
- It is a single-user tool with no login. Do not expose the port to a network (no reverse proxy, no port forwarding).
To report a vulnerability, see SECURITY.md.
- Single user, single machine. There is no remote access.
- The Claude Code
.jsonlformat is not a public contract. Unknown record types are counted and skipped, but a format change can hide some data.
gofmt -l . # must print nothing
go vet ./... && go test -race -count=1 ./... # takes a couple of minutes
cd web && npm run typecheck && npx vitest run && npm run e2enpm cideletesweb/node_modulesand reinstalls it. Run it on purpose.- Try it without touching your real data:
DRASHTA_HOME=$(mktemp -d) ./drashta -port 4467. Check the port is free first withlsof -nP -iTCP:4467 -sTCP:LISTEN. npm --prefix web run devstarts the Vite dev server (run drashta with-devbeside it).npm --prefix web run dev:mockruns the UI on mock data, which is how the screenshots above were made.- After any UI change, check the layout in a headless browser at 1440x900 and 1000x665. Unit tests cannot see layout.
Where things live:
cmd/drashta: entry point and command line.internal/: Go packages. Each has adoc.gothat lists its API.web/: the React app, built intoweb/build/clientand embedded in the binary.docs/: architecture, decisions and specs. Start withdocs/README.md.contrib/desktop/: the optional wallpaper-mode scripts.
Issues and pull requests are welcome. See CONTRIBUTING.md.
MIT. See LICENSE.

