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

45 lines
1.2 KiB
Markdown

# 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:
```bash
npm install
npm run verify
```
Run the local server:
```bash
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.
## Related Surfaces
- `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.