Canvas UI

Downloads

• Latest release (recommended): Latest release
• All releases: All releases

Config/Data Storage

• Linux/Mac: ~/.canvas/electron/agents/<agent-name>/
• Windows: %APPDATA%/Canvas/electron/agents/<agent-name>/
• Format: Plain JSON files with datetime stamps
• Structure: YYYY-MM-DDTHH-mm-ss-conversation.json

Development

Prerequisites

• Node.js 20.x or higher
• npm or yarn package manager

Setup

# Clone the repository
git clone <repository-url>
cd canvas

# Install dependencies
npm install

# Development mode
npm run dev

# Build for production
npm run build

# Package the application
npm run package

Development Scripts

• npm run dev - Start both main and renderer in development mode
• npm run dev:main - Build and run main process only
• npm run dev:renderer - Start Vite dev server for renderer
• npm run build - Build both main and renderer for production
• npm run build:main - Build main process only
• npm run build:renderer - Build renderer only
• npm run lint - Run ESLint on all TypeScript files
• npm run type-check - Run TypeScript type checking

Development Build

npm run build

How to cut a release

Tag and push (tag should match our versioning convention):

git tag v2.0.0-alpha.1
git push origin v2.0.0-alpha.1

GitHub Actions will build + create a Release with the installers.

Production Package

npm run package

This creates platform-specific packages in the release/ directory:

• Linux: AppImage
• Windows: NSIS installer
• macOS: DMG file

License

AGPL-3.0-or-later - see LICENSE file for details.

Roadmap

• Main management app