Develop this monorepo

This repository is the CLI, core, and SDK workspace. Use it when you change Shellui itself. App authors should follow Create a project with the published CLI.

.
├── packages/
│   ├── cli/
│   ├── core/
│   └── sdk/
├── docs/
├── tools/
└── package.json

Agent skills live in the sibling repo shellui/skills (../skills). When you change public CLI, SDK, or config behavior, update the matching skill there and keep it small - see ADR 0001.

Workflow

This project uses pnpm 9 (packageManager in root package.json).

npm install -g pnpm
pnpm install
pnpm run build

Individual packages:

pnpm run build:cli
pnpm run build:core
pnpm run build:sdk

Tests:

pnpm test

@shellui/cli depends on @shellui/core. @shellui/core depends on @shellui/sdk. Workspace links mean a core change is visible to the CLI without publishing.

Useful root scripts: pnpm start / pnpm run serve (CLI start), pnpm run docs:start, pnpm run tauri:dev. See the root README for the full list. Format and lint: pnpm run format, pnpm run lint.

The docs site also renders the service docs from identity-service, storage-service, hosting-service, and email-service. See Docs site for how they are fetched and how to edit them with live reload.

Workflow​

Workflow