claudegoodies
CLAUDE.md

rowboat CLAUDE.md

From rowboatlabs

This file provides context for AI coding agents working on the Rowboat monorepo.

Documents build commands, workspace structure, and file locations for Rowboat's Electron app (apps/x).

Use it when

  • Building or debugging the apps/x Electron/pnpm workspace
  • Need the shared→core→preload build order or entry point paths
  • Adding a shared type, new dependency, or modifying main/renderer process
  • Configuring LLM providers via ~/.rowboat/config/models.json

Skip it if

  • Not working inside the Rowboat monorepo
  • Specific to this pnpm/esbuild/Electron Forge setup, not general Electron advice
  • macOS-specific packaging/signing details (APPLE_ID etc.)

Facts

Repository
rowboatlabs/rowboat
Status
Actively maintained
Last commit
Source file
CLAUDE.md

Source preview

The instructions Claude Code reads when this claude.md runs.

# CLAUDE.md - AI Coding Agent Context

This file provides context for AI coding agents working on the Rowboat monorepo.

## Quick Reference Commands

```bash
# Electron App (apps/x)
cd apps/x && pnpm install          # Install dependencies
cd apps/x && npm run deps          # Build workspace packages (shared → core → preload)
cd apps/x && npm run dev           # Development mode (builds deps, runs app)
cd apps/x && npm run lint          # Lint check
cd apps/x/apps/main && npm run package   # Production build (.app)
cd apps/x/apps/main && npm run make      # Create DMG distributable
```

## Monorepo Structure

```
rowboat/
├── apps/
│   ├── x/                 # Electron desktop app (focus of this doc)
│   ├── rowboat/           # Next.js web dashboard
│   ├── rowboatx/          # Next.js frontend
│   ├── cli/               # CLI tool
│   ├── python-sdk/        # Python SDK
│   └── docs/              # Documentation site
├── CLAUDE.md              # This file
└── README.md              # User-facing readme
```

## Electron App Architecture (`apps/x`)

The Electron app is a **nested pnpm workspace** with its own package management.

```
apps/x/
├── package.json           # Workspace root, dev scripts
├── pnpm-workspace.yaml    # Defines workspace packages
├── pnpm-lock.yaml         # Lockfile
├── apps/
│   ├── main/              # Electron main process
│   │   ├── src/           #
View full source on GitHub →

Other claude.md files