code/dev_pm_agent
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
No description
12 commits 1 branch 0 tags 216 KiB
  • Rust 55.6%
  • TypeScript 37.5%
  • CSS 6.7%
  • HTML 0.1%
  • JavaScript 0.1%
Find a file
Exact
lifejkskla c40c515c3c Add CODEOWNERS for org code maintainers.
2026-09-02 14:18:41 +00:00
.cursor/rules Initial commit 2026-02-11 15:49:27 +09:00
.github/workflows Initial commit 2026-02-11 15:49:27 +09:00
apps/web Fix theme 2026-02-12 10:21:47 +09:00
config Initial commit 2026-02-11 15:49:27 +09:00
crates Fix accumulated events 2026-02-12 11:09:55 +09:00
docs Remaining beta features 2026-02-11 22:48:38 +09:00
migrations Remaining beta features 2026-02-11 22:48:38 +09:00
security_reviews Fix cors 2026-02-12 10:58:31 +09:00
sprints Initial commit 2026-02-11 15:49:27 +09:00
.env.example Fix cors 2026-02-12 10:58:31 +09:00
.gitignore Initial commit 2026-02-11 15:49:27 +09:00
.gitleaks.toml Initial commit 2026-02-11 15:49:27 +09:00
.pre-commit-config.yaml Add gitleaks precommit hook 2026-02-11 15:51:18 +09:00
Cargo.toml Initial commit 2026-02-11 15:49:27 +09:00
CODEOWNERS Add CODEOWNERS for org code maintainers. 2026-09-02 14:18:41 +00:00
LICENSE Update licensing 2026-02-11 23:00:12 +09:00
PLAN.md Initial commit 2026-02-11 15:49:27 +09:00
README.md Update licensing 2026-02-11 23:00:12 +09:00
render.yaml Fix cors 2026-02-12 10:58:31 +09:00

README.md

Dev PM Agent

Remote Cursor CLI controller — run development tasks from your phone via web chat.

See PLAN.md for the full project design and implementation plan.

Quick start

# 1. Copy .env.example, generate secrets
# Required: JWT_SECRET, EXECUTOR_API_KEY, PASSWORD_SALT, CLIENT_SALT (CLIENT_SALT = VITE_CLIENT_SALT in apps/web/.env)
# Generate each: openssl rand -hex 32  (min 32 bytes = 64 hex chars)
# Rotate: set new env vars, restart relayer; JWTs expire by TTL; users re-login

# 2. Run relayer (backend)
source .env && cargo run -p relayer

# 3. Run executor (in another terminal; requires Cursor CLI)
source .env && cargo run -p executor

# 4. Frontend
cd apps/web
cp .env.example .env   # set VITE_CLIENT_SALT (same value as root CLIENT_SALT)
npm install && npm run dev

Then open http://localhost:5173. First-run setup:

  1. Get device key (CLI): source .env && cargo run -p executor -- bootstrap-device
  2. Web Setup: paste device key → verify → create account (username, password)
  3. Add TOTP to authenticator, then Login with device key + password + TOTP

The device key is never stored in the browser — enter it at each login.

Deploy to Render

  1. Create a Blueprint in Render (New → Blueprint → connect repo → Apply).
  2. Set env vars for dev-pm-relayer: JWT_SECRET, EXECUTOR_API_KEY, PASSWORD_SALT (generate with openssl rand -hex 32).
  3. After relayer deploys, set VITE_RELAYER_URL for dev-pm-webapp to https://<relayer-service>.onrender.com, then redeploy.
  4. Run executor locally with: 
    export EXECUTOR_API_KEY=<same-as-relayer>
export RELAYER_WS_URL=wss://<relayer-service>.onrender.com/ws
cargo run -p executor

See sprints/SPRINT_004.md for the full deployment checklist and local test flow.

Secrets

  • Length: Use at least 32 bytes (64 hex characters). Generate: openssl rand -hex 32
  • Rotation: Set new values in env, restart the relayer. Existing JWTs expire per JWT_TTL_SECS; users must re-login. Device API keys remain valid until devices are re-registered.

Executor subcommands

  • cargo run -p executor — run daemon (default)
  • cargo run -p executor -- bootstrap-device — get device key for first-run setup (relayer must be running)
  • cargo run -p executor -- register-device <word-code> <password> — register new webapp device

License

Licensed under the AGPL-3.0 License. See LICENSE for details.