Development Setup#

Start from the repo root#

pnpm install
pnpm dev

pnpm dev is the public first-run command surface for the OSS alpha.

Common contributor checks#

pnpm typecheck
pnpm build
pnpm test
pnpm test:ci
pnpm eval:snapshot

What those commands mean today#

• pnpm typecheck — workspace typecheck across packages and desktop Electron TS
• pnpm build — workspace build
• pnpm test — desktop Vitest suite
• pnpm test:ci — current alpha PR-gate shape: typecheck, build, desktop tests, desktop CI e2e (pnpm --filter @sero/desktop test:e2e:ci)
• pnpm eval:snapshot — fast prompt assembly/cache drift check

For live provider evals, use pnpm eval only when credentials and budget are available. See Running Evals and Testing / Evals.

Runtime notes#

• Apple containers are the preferred runtime for the full feature set.
• Host mode remains supported as a reduced fallback.
• If native terminal support breaks, use the node-pty troubleshooting guidance from the repo docs.

Evals#

Evals are a separate signal from typecheck/build/unit/e2e tests. Snapshot evals are fast and do not make live LLM calls. Full evals use promptfoo with real providers and may cost money.

Start with Running Evals for the task flow, then use Testing / Evals for exact commands and scenario coverage.

Contributor guidance#

For contribution workflow, PR expectations, and security reporting, see the root OSS files in the repository:

• CONTRIBUTING.md
• SECURITY.md
• CODE_OF_CONDUCT.md