Contributing
Bug reports, ideas, docs and code are all welcome. The repository's CONTRIBUTING.md has the full workflow; this page is the short version.
How it is built
A pnpm monorepo in strict TypeScript: the daemon (apps/daemon, Node), the app (apps/mobile, Expo and React Native), the push relay (apps/push-relay, a Cloud Function), this site (apps/web, a Node server in Docker) and the WebSocket protocol they share (packages/protocol, Zod schemas). Every feature starts as an OpenSpec change with a proposal, spec deltas and tasks; the archived changes are the project's history. Architecture and conventions live in CLAUDE.md.
Setup
macOS or Linux with Node 24+, pnpm 12+, tmux, git, ripgrep and zsh; Xcode on a Mac for iOS, the Android SDK with JDK 17 for Android.
pnpm install
pnpm check # typecheck + tests + Biome, must be green
pnpm --filter @remote-harness/daemon dev start --dev # daemon from source on 127.0.0.1
pnpm --filter @remote-harness/mobile ios # app on the iOS simulator
pnpm --filter @remote-harness/mobile android # app on an Android emulator
Workflow
- For anything bigger than a small fix, open an issue first.
- Branch from
development(feat/<topic>,fix/<topic>,docs/<topic>);mainholds releases only. - Behavior changes start as an OpenSpec change (
openspec validate <change> --strict), written in English. - UI text goes through the typed catalogs in pt-BR, en-US and es-ES; pure logic gets Vitest tests.
- Commit with Conventional Commits, open a pull request against
development.
Reporting bugs
Use the issue template and include remote-harness doctor, the versions (OS, Node, Claude Code, the app) and the daemon logs from ~/.remote-harness/logs, with tokens and session content removed. Security issues go through GitHub Security Advisories, never public issues.
License
MIT. By contributing you agree that your contributions are licensed the same way.