Registry / productivity / local-todo

local-todo

JSON →
library1.0.25jsnpmunverified

Self-hosted todo/kanban/docs app with a full stack shipped in a single npm package: API, React UI, and embedded Postgres database. Version 1.0.25, updated frequently on npm. No Docker, no external database, no cloud account required. Differentiators: zero external infrastructure dependencies, runs via npx with a one-time Postgres binary download (~50 MB), supports background service mode with macOS launchd/Linux systemd integration, LAN sharing for OAuth/MCP clients, and automatic daily update checks.

productivity
npm install local-todo
package ↗
INSTALL
IMPORT
SIG · LOCAL-TODO
L
local-todo
productivityjavascriptv1.0.25
harness data pending
Install & Compatibility
Where this runs

No compatibility data collected yet for this library.

Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

local-todo
✓ npx local-todo
✗ npm install -g local-todo && local-todo (works but npx is simpler)
Primary way to run the app. npx ensures latest version.
start
✓ local-todo start
Starts the server in background mode. Returns immediately.
stop
✓ local-todo stop
Sends SIGINT for clean shutdown.

Runs the app via npx, opens browser at localhost:3001, stops with Ctrl+C.

npx local-todo # Open http://localhost:3001 # Ctrl+C to stop
Debug
Known issues
gotchanvm users may hit 'command not found: local-todo' after global install due to PATH issues.
fix
Use `npx local-todo` instead, or configure nvm's default PATH.
affects: >=1.0.0
gotchaFirst run downloads ~50 MB of Postgres binaries (one-time). Do not interrupt network during download.
fix
Ensure stable internet connection on first boot.
affects: >=1.0.0
gotchaConfig changes after `local-todo enable` are not applied until re-running `local-todo enable` to bake new values.
fix
Run `local-todo enable` again after changing config.
affects: >=1.0.0
gotchaPlain HTTP is not suitable for exposure over the open internet. Use a reverse proxy with TLS.
fix
Put nginx/Caddy in front with TLS certificate.
affects: >=1.0.0
deprecatedNo deprecated features in current version.
fix
N/A
affects: >=1.0.0
Errors
Common errors & fixes
command not found: local-todo
Global install via npm may not be on PATH, especially with nvm.
fix
Use `npx local-todo` instead of calling `local-todo` directly.
Error: EACCES: permission denied, unlink '/home/user/.local-todo/pg/...'
Background process still running when trying to wipe data.
fix
Run `local-todo stop` before `rm -rf ~/.local-todo`.
FATAL: could not open directory "pg_wal": No such file or directory
Postgres binary download was interrupted or corrupted.
fix
Delete `~/.local-todo/pg` and re-run `npx local-todo`.
Upgrade
Version history
1.0.25latest on npm
Audit
Dependencies

No dependency data recorded yet.

Agent activity
25 hits · last 30 days
node
22
OpenAI (training)
1
Resources
packagelocal-todo ↗
local-todo — npm install local-todo · libregistry