rowboat/apps/cli/README.md
nocxcloud-oss 4239f9f1ef strengthen repo verification and runtime coverage
Add clearer app docs plus targeted desktop, CLI, web, and worker tests so cross-surface regressions are caught earlier and the repo is easier to navigate.
2026-04-15 19:10:41 +08:00

1.2 KiB

Rowboat CLI And Local Runtime

apps/cli contains the npm-distributed @rowboatlabs/rowboatx package and the local HTTP runtime used by the newer frontend.

What Lives Here

  • Hono server for runs, messages, permissions, and SSE streaming
  • Model and MCP configuration repositories under ~/.rowboat
  • Workflow import and export helpers
  • Packaged CLI entrypoint in bin/app.js

Local Development

Install and build:

npm install
npm run verify

Run the local server:

npm run server

Key Commands

  • npm run build - compile TypeScript into dist/
  • npm run lint - run CLI lint checks
  • npm run typecheck - run TypeScript checks without emitting
  • npm run server - start the local Hono runtime
  • npm run verify - run lint, typecheck, and tests together
  • npm run migrate-agents - run bundled agent migration script

Data Location

The CLI/runtime stores configuration and runtime state in ~/.rowboat by default.

  • apps/rowboatx provides the newer frontend that talks to this runtime
  • apps/x has its own local-first desktop runtime and is the primary desktop product

See the root ARCHITECTURE.md for the repo-level map.