{"owner":"stagewise-io","repo":"stagewise","hasSkills":true,"hasMcp":false,"mcpConfig":null,"found":["CLAUDE.md","AGENTS.md"],"skills":{"CLAUDE.md":"# Claude Code instructions\n\n@AGENTS.md\n","AGENTS.md":"# AGENTS.md\n\nThis file provides guidance to AI coding agents when working with code in this repository.\n\n## Essential Commands\n\n### Development\n- `pnpm install` - Install dependencies (Node >= 22.12.0, pnpm 10.30.3 required)\n- `pnpm dev` - Start workspace development tasks in Turbo watch mode\n\n### Building\n- `pnpm build` - Run all configured workspace build tasks\n- `pnpm build:apps` - Build applications only (`apps/*`)\n- `pnpm build:packages` - Build packages only (`packages/*`)\n\n### Code Quality\n- `pnpm check` - Run Biome linting/formatting checks (read-only)\n- `pnpm check:fix` - Auto-fix linting/formatting issues across the repository\n- `pnpm typecheck` - Run configured workspace `typecheck` tasks\n- `pnpm -F @stagewise/agent-runtime-node type-check` - Typecheck the Node agent runtime (its script name differs)\n\n### Testing\n- `pnpm test` - Run configured workspace test tasks via Vitest\n- `pnpm -F <package-name> test` - Run tests for a specific package (e.g., `pnpm -F @stagewise/karton test`)\n\n### Browser App Specific\n- `pnpm -F stagewise start` - Start the Electron browser app with typechecking\n- `pnpm -F stagewise start:fast` - Start the Electron browser app without the initial typecheck\n- `pnpm -F stagewise start:isolated` - Start with an isolated development profile\n- `pnpm -F stagewise storybook` - Start Storybook for browser UI components\n- `pnpm -F stagewise typecheck` - Typecheck browser UI, backend, web-content preload, and Storybook code\n- `pnpm --dir apps/browser exec tsc -p tsconfig.pages.json --noEmit` - Typecheck Chromium pages separately\n- `pnpm -F stagewise test` - Run browser app tests\n\n### Maintenance\n- `pnpm clean` - Clean root node_modules\n- `pnpm clean:workspaces` - Run configured workspace clean tasks\n- `pnpm clean:browser-data-isolated` - Remove isolated browser development profiles only\n\n## Architecture Overview\n\nStagewise is a pnpm workspace and Turborepo monorepo. The product is an open-source agentic IDE with a built-in coding agent. Its main Electron browser combines browsing, debugging, editing, and agent workflows.\n\n### Directory Structure\n\n```\napps/\n  browser/        - Electron app and main product (package `stagewise`)\n  stagewise-cli/  - Headless host for the extracted agent packages\n  deprecated-cli/ - Legacy v0.12 CLI; do not extend for new agent work\n  website/        - Public website (Next.js 16)\n  update-server/  - Electron update server\n\npackages/\n  agent-core/     - Host-agnostic agent runtime, state, commands, and tools\n  agent-shell/    - Reusable PTY and shell environment\n  icons/          - Canonical shared icon package\n  karton/         - Typed client/server state and procedure transport\n  stage-ui/       - Shared React component library and design system\n  tailwindcss-color-modifiers/ - Custom Tailwind CSS utilities\n  typescript-config/ - Shared TypeScript configurations\n\nagent/\n  runtime-node/   - Node-specific filesystem, glob, grep, and watch runtime\n\n.agents/skills/   - Repository workflows and domain-specific guidance\n```\n\n### Key Technologies\n- **Runtime**: Node.js 22.12+\n- **Package Manager**: pnpm 10.30.3 (always use pnpm, never npm/yarn)\n- **Build**: Turborepo for task orchestration, Vite/esbuild for bundling\n- **Language**: TypeScript (strict mode)\n- **Linting/Formatting**: Biome 2 (NOT ESLint or Prettier)\n- **Desktop**: Electron with Electron Forge\n- **Frontend**: React 19, Tailwind CSS 4\n- **Website**: Next.js 16\n- **Testing**: Vitest\n\n## Code Style\n\nEnforced by Biome:\n- 2-space indentation\n- Single quotes for JS/TS strings\n- Double quotes for JSX attributes\n- Semicolons always\n- 80 character line width\n- Trailing commas\n\nNaming conventions:\n- camelCase for functions/variables\n- PascalCase for components/classes\n- kebab-case for directories/files\n\n## Commit Guidelines\n\n**Conventional Commits with mandatory scopes:**\n\n```\n<type>(<scope>): <description>\n```\n\nTypes: `build`, `chore`, `ci`, `docs`, `feat`, `fix`, `perf`, `refactor`, `revert`, `style`, `test`\n\nScopes use pnpm workspace package basenames without the `@stagewise/` prefix:\n- `stagewise` - apps/browser\n- `stagewise-cli` - apps/stagewise-cli or apps/deprecated-cli\n- `website` - apps/website\n- `update-server` - apps/update-server\n- `agent-core` - packages/agent-core\n- `agent-shell` - packages/agent-shell\n- `agent-runtime-node` - agent/runtime-node\n- `icons` - packages/icons\n- `karton` - packages/karton\n- `stage-ui` - packages/stage-ui\n- `tailwindcss-color-modifiers` - packages/tailwindcss-color-modifiers\n- `typescript-config` - packages/typescript-config\n- `global` - root or cross-workspace changes\n\nExamples:\n```bash\nfeat(stagewise): add isolated profile selector\nfix(agent-core): preserve mount state during retry\nchore(global): update workspace tooling\n```\n\nSub-scopes like `browser-ui` are NOT valid - use the parent package scope.\n\n## Pre-commit Hooks\n\nLefthook runs on commit:\n1. Biome formats staged supported files\n2. `pnpm check` runs the repository Biome check\n3. Browser typecheck runs if browser TypeScript files changed\n4. Commitlint validates the commit message\n\n## Workspace Dependencies\n\n- Use `workspace:*` protocol for inter-package dependencies\n- Add to root: `pnpm add <package> -w`\n- Add to specific package: `pnpm add <package> --filter <package-name>`\n- Do not edit `pnpm-lock.yaml` manually\n\n## Browser App Architecture\n\nThe main Electron app (`apps/browser`) has multiple TypeScript configs:\n- `tsconfig.ui.json` - React UI code\n- `tsconfig.pages.json` - Chromium page renderer and routes\n- `tsconfig.backend.json` - Electron main process\n- `tsconfig.web-content-preload.json` - Web-content preload scripts\n- `tsconfig.storybook.json` - Storybook configuration\n\nKey dependencies include AI SDK provider integrations, TipTap, TanStack Router, Karton, Stage UI, and the extracted agent packages. Model routing is instance-aware: preserve the `(providerInstanceId, modelId)` pair and keep provider implementations under `apps/browser/src/backend/agents/providers`.\n\n## Important Notes\n\n1. **Biome is the linter/formatter** - NOT ESLint or Prettier\n2. **Always run `pnpm check:fix` before committing**\n3. **TypeScript strict mode** is enabled - handle all type errors\n4. **Turbo caching** is enabled - build outputs are cached\n5. **The browser app uses Electron Forge** for packaging and distribution\n"},"files":{"CLAUDE.md":"# Claude Code instructions\n\n@AGENTS.md\n","AGENTS.md":"# AGENTS.md\n\nThis file provides guidance to AI coding agents when working with code in this repository.\n\n## Essential Commands\n\n### Development\n- `pnpm install` - Install dependencies (Node >= 22.12.0, pnpm 10.30.3 required)\n- `pnpm dev` - Start workspace development tasks in Turbo watch mode\n\n### Building\n- `pnpm build` - Run all configured workspace build tasks\n- `pnpm build:apps` - Build applications only (`apps/*`)\n- `pnpm build:packages` - Build packages only (`packages/*`)\n\n### Code Quality\n- `pnpm check` - Run Biome linting/formatting checks (read-only)\n- `pnpm check:fix` - Auto-fix linting/formatting issues across the repository\n- `pnpm typecheck` - Run configured workspace `typecheck` tasks\n- `pnpm -F @stagewise/agent-runtime-node type-check` - Typecheck the Node agent runtime (its script name differs)\n\n### Testing\n- `pnpm test` - Run configured workspace test tasks via Vitest\n- `pnpm -F <package-name> test` - Run tests for a specific package (e.g., `pnpm -F @stagewise/karton test`)\n\n### Browser App Specific\n- `pnpm -F stagewise start` - Start the Electron browser app with typechecking\n- `pnpm -F stagewise start:fast` - Start the Electron browser app without the initial typecheck\n- `pnpm -F stagewise start:isolated` - Start with an isolated development profile\n- `pnpm -F stagewise storybook` - Start Storybook for browser UI components\n- `pnpm -F stagewise typecheck` - Typecheck browser UI, backend, web-content preload, and Storybook code\n- `pnpm --dir apps/browser exec tsc -p tsconfig.pages.json --noEmit` - Typecheck Chromium pages separately\n- `pnpm -F stagewise test` - Run browser app tests\n\n### Maintenance\n- `pnpm clean` - Clean root node_modules\n- `pnpm clean:workspaces` - Run configured workspace clean tasks\n- `pnpm clean:browser-data-isolated` - Remove isolated browser development profiles only\n\n## Architecture Overview\n\nStagewise is a pnpm workspace and Turborepo monorepo. The product is an open-source agentic IDE with a built-in coding agent. Its main Electron browser combines browsing, debugging, editing, and agent workflows.\n\n### Directory Structure\n\n```\napps/\n  browser/        - Electron app and main product (package `stagewise`)\n  stagewise-cli/  - Headless host for the extracted agent packages\n  deprecated-cli/ - Legacy v0.12 CLI; do not extend for new agent work\n  website/        - Public website (Next.js 16)\n  update-server/  - Electron update server\n\npackages/\n  agent-core/     - Host-agnostic agent runtime, state, commands, and tools\n  agent-shell/    - Reusable PTY and shell environment\n  icons/          - Canonical shared icon package\n  karton/         - Typed client/server state and procedure transport\n  stage-ui/       - Shared React component library and design system\n  tailwindcss-color-modifiers/ - Custom Tailwind CSS utilities\n  typescript-config/ - Shared TypeScript configurations\n\nagent/\n  runtime-node/   - Node-specific filesystem, glob, grep, and watch runtime\n\n.agents/skills/   - Repository workflows and domain-specific guidance\n```\n\n### Key Technologies\n- **Runtime**: Node.js 22.12+\n- **Package Manager**: pnpm 10.30.3 (always use pnpm, never npm/yarn)\n- **Build**: Turborepo for task orchestration, Vite/esbuild for bundling\n- **Language**: TypeScript (strict mode)\n- **Linting/Formatting**: Biome 2 (NOT ESLint or Prettier)\n- **Desktop**: Electron with Electron Forge\n- **Frontend**: React 19, Tailwind CSS 4\n- **Website**: Next.js 16\n- **Testing**: Vitest\n\n## Code Style\n\nEnforced by Biome:\n- 2-space indentation\n- Single quotes for JS/TS strings\n- Double quotes for JSX attributes\n- Semicolons always\n- 80 character line width\n- Trailing commas\n\nNaming conventions:\n- camelCase for functions/variables\n- PascalCase for components/classes\n- kebab-case for directories/files\n\n## Commit Guidelines\n\n**Conventional Commits with mandatory scopes:**\n\n```\n<type>(<scope>): <description>\n```\n\nTypes: `build`, `chore`, `ci`, `docs`, `feat`, `fix`, `perf`, `refactor`, `revert`, `style`, `test`\n\nScopes use pnpm workspace package basenames without the `@stagewise/` prefix:\n- `stagewise` - apps/browser\n- `stagewise-cli` - apps/stagewise-cli or apps/deprecated-cli\n- `website` - apps/website\n- `update-server` - apps/update-server\n- `agent-core` - packages/agent-core\n- `agent-shell` - packages/agent-shell\n- `agent-runtime-node` - agent/runtime-node\n- `icons` - packages/icons\n- `karton` - packages/karton\n- `stage-ui` - packages/stage-ui\n- `tailwindcss-color-modifiers` - packages/tailwindcss-color-modifiers\n- `typescript-config` - packages/typescript-config\n- `global` - root or cross-workspace changes\n\nExamples:\n```bash\nfeat(stagewise): add isolated profile selector\nfix(agent-core): preserve mount state during retry\nchore(global): update workspace tooling\n```\n\nSub-scopes like `browser-ui` are NOT valid - use the parent package scope.\n\n## Pre-commit Hooks\n\nLefthook runs on commit:\n1. Biome formats staged supported files\n2. `pnpm check` runs the repository Biome check\n3. Browser typecheck runs if browser TypeScript files changed\n4. Commitlint validates the commit message\n\n## Workspace Dependencies\n\n- Use `workspace:*` protocol for inter-package dependencies\n- Add to root: `pnpm add <package> -w`\n- Add to specific package: `pnpm add <package> --filter <package-name>`\n- Do not edit `pnpm-lock.yaml` manually\n\n## Browser App Architecture\n\nThe main Electron app (`apps/browser`) has multiple TypeScript configs:\n- `tsconfig.ui.json` - React UI code\n- `tsconfig.pages.json` - Chromium page renderer and routes\n- `tsconfig.backend.json` - Electron main process\n- `tsconfig.web-content-preload.json` - Web-content preload scripts\n- `tsconfig.storybook.json` - Storybook configuration\n\nKey dependencies include AI SDK provider integrations, TipTap, TanStack Router, Karton, Stage UI, and the extracted agent packages. Model routing is instance-aware: preserve the `(providerInstanceId, modelId)` pair and keep provider implementations under `apps/browser/src/backend/agents/providers`.\n\n## Important Notes\n\n1. **Biome is the linter/formatter** - NOT ESLint or Prettier\n2. **Always run `pnpm check:fix` before committing**\n3. **TypeScript strict mode** is enabled - handle all type errors\n4. **Turbo caching** is enabled - build outputs are cached\n5. **The browser app uses Electron Forge** for packaging and distribution\n"},"items":[{"name":"CLAUDE.md","path":"CLAUDE.md","title":"CLAUDE.md","content":"# Claude Code instructions\n\n@AGENTS.md\n","category":"root","tokens":10},{"name":"AGENTS.md","path":"AGENTS.md","title":"AGENTS.md","content":"# AGENTS.md\n\nThis file provides guidance to AI coding agents when working with code in this repository.\n\n## Essential Commands\n\n### Development\n- `pnpm install` - Install dependencies (Node >= 22.12.0, pnpm 10.30.3 required)\n- `pnpm dev` - Start workspace development tasks in Turbo watch mode\n\n### Building\n- `pnpm build` - Run all configured workspace build tasks\n- `pnpm build:apps` - Build applications only (`apps/*`)\n- `pnpm build:packages` - Build packages only (`packages/*`)\n\n### Code Quality\n- `pnpm check` - Run Biome linting/formatting checks (read-only)\n- `pnpm check:fix` - Auto-fix linting/formatting issues across the repository\n- `pnpm typecheck` - Run configured workspace `typecheck` tasks\n- `pnpm -F @stagewise/agent-runtime-node type-check` - Typecheck the Node agent runtime (its script name differs)\n\n### Testing\n- `pnpm test` - Run configured workspace test tasks via Vitest\n- `pnpm -F <package-name> test` - Run tests for a specific package (e.g., `pnpm -F @stagewise/karton test`)\n\n### Browser App Specific\n- `pnpm -F stagewise start` - Start the Electron browser app with typechecking\n- `pnpm -F stagewise start:fast` - Start the Electron browser app without the initial typecheck\n- `pnpm -F stagewise start:isolated` - Start with an isolated development profile\n- `pnpm -F stagewise storybook` - Start Storybook for browser UI components\n- `pnpm -F stagewise typecheck` - Typecheck browser UI, backend, web-content preload, and Storybook code\n- `pnpm --dir apps/browser exec tsc -p tsconfig.pages.json --noEmit` - Typecheck Chromium pages separately\n- `pnpm -F stagewise test` - Run browser app tests\n\n### Maintenance\n- `pnpm clean` - Clean root node_modules\n- `pnpm clean:workspaces` - Run configured workspace clean tasks\n- `pnpm clean:browser-data-isolated` - Remove isolated browser development profiles only\n\n## Architecture Overview\n\nStagewise is a pnpm workspace and Turborepo monorepo. The product is an open-source agentic IDE with a built-in coding agent. Its main Electron browser combines browsing, debugging, editing, and agent workflows.\n\n### Directory Structure\n\n```\napps/\n  browser/        - Electron app and main product (package `stagewise`)\n  stagewise-cli/  - Headless host for the extracted agent packages\n  deprecated-cli/ - Legacy v0.12 CLI; do not extend for new agent work\n  website/        - Public website (Next.js 16)\n  update-server/  - Electron update server\n\npackages/\n  agent-core/     - Host-agnostic agent runtime, state, commands, and tools\n  agent-shell/    - Reusable PTY and shell environment\n  icons/          - Canonical shared icon package\n  karton/         - Typed client/server state and procedure transport\n  stage-ui/       - Shared React component library and design system\n  tailwindcss-color-modifiers/ - Custom Tailwind CSS utilities\n  typescript-config/ - Shared TypeScript configurations\n\nagent/\n  runtime-node/   - Node-specific filesystem, glob, grep, and watch runtime\n\n.agents/skills/   - Repository workflows and domain-specific guidance\n```\n\n### Key Technologies\n- **Runtime**: Node.js 22.12+\n- **Package Manager**: pnpm 10.30.3 (always use pnpm, never npm/yarn)\n- **Build**: Turborepo for task orchestration, Vite/esbuild for bundling\n- **Language**: TypeScript (strict mode)\n- **Linting/Formatting**: Biome 2 (NOT ESLint or Prettier)\n- **Desktop**: Electron with Electron Forge\n- **Frontend**: React 19, Tailwind CSS 4\n- **Website**: Next.js 16\n- **Testing**: Vitest\n\n## Code Style\n\nEnforced by Biome:\n- 2-space indentation\n- Single quotes for JS/TS strings\n- Double quotes for JSX attributes\n- Semicolons always\n- 80 character line width\n- Trailing commas\n\nNaming conventions:\n- camelCase for functions/variables\n- PascalCase for components/classes\n- kebab-case for directories/files\n\n## Commit Guidelines\n\n**Conventional Commits with mandatory scopes:**\n\n```\n<type>(<scope>): <description>\n```\n\nTypes: `build`, `chore`, `ci`, `docs`, `feat`, `fix`, `perf`, `refactor`, `revert`, `style`, `test`\n\nScopes use pnpm workspace package basenames without the `@stagewise/` prefix:\n- `stagewise` - apps/browser\n- `stagewise-cli` - apps/stagewise-cli or apps/deprecated-cli\n- `website` - apps/website\n- `update-server` - apps/update-server\n- `agent-core` - packages/agent-core\n- `agent-shell` - packages/agent-shell\n- `agent-runtime-node` - agent/runtime-node\n- `icons` - packages/icons\n- `karton` - packages/karton\n- `stage-ui` - packages/stage-ui\n- `tailwindcss-color-modifiers` - packages/tailwindcss-color-modifiers\n- `typescript-config` - packages/typescript-config\n- `global` - root or cross-workspace changes\n\nExamples:\n```bash\nfeat(stagewise): add isolated profile selector\nfix(agent-core): preserve mount state during retry\nchore(global): update workspace tooling\n```\n\nSub-scopes like `browser-ui` are NOT valid - use the parent package scope.\n\n## Pre-commit Hooks\n\nLefthook runs on commit:\n1. Biome formats staged supported files\n2. `pnpm check` runs the repository Biome check\n3. Browser typecheck runs if browser TypeScript files changed\n4. Commitlint validates the commit message\n\n## Workspace Dependencies\n\n- Use `workspace:*` protocol for inter-package dependencies\n- Add to root: `pnpm add <package> -w`\n- Add to specific package: `pnpm add <package> --filter <package-name>`\n- Do not edit `pnpm-lock.yaml` manually\n\n## Browser App Architecture\n\nThe main Electron app (`apps/browser`) has multiple TypeScript configs:\n- `tsconfig.ui.json` - React UI code\n- `tsconfig.pages.json` - Chromium page renderer and routes\n- `tsconfig.backend.json` - Electron main process\n- `tsconfig.web-content-preload.json` - Web-content preload scripts\n- `tsconfig.storybook.json` - Storybook configuration\n\nKey dependencies include AI SDK provider integrations, TipTap, TanStack Router, Karton, Stage UI, and the extracted agent packages. Model routing is instance-aware: preserve the `(providerInstanceId, modelId)` pair and keep provider implementations under `apps/browser/src/backend/agents/providers`.\n\n## Important Notes\n\n1. **Biome is the linter/formatter** - NOT ESLint or Prettier\n2. **Always run `pnpm check:fix` before committing**\n3. **TypeScript strict mode** is enabled - handle all type errors\n4. **Turbo caching** is enabled - build outputs are cached\n5. **The browser app uses Electron Forge** for packaging and distribution\n","category":"root","tokens":1580}]}