Install

Screenchart quickstart

Screenchart runs locally on your machine. A few commands take you from a clean clone to a running app with your AI provider connected. Latest stable release: v0.1.0.

Requirements

  • Node.js 20 LTS or newer: install via your platform package manager or nodejs.org.
  • npm: the package manager this repo uses (bundled with Node.js).
  • git: any recent version. Get it at git-scm.com.
  • An AI provider: either a local CLI agent (Claude Code, Antigravity, Codex CLI, etc.) or an API key for Claude, OpenAI, Gemini, or an OpenAI-compatible gateway.

Commands to get running

Clone and install

Pull the repository and install dependencies.

terminal 
git clone https://github.com/AshishB2000/screenchart.git
cd screenchart
npm install

Run the app

Start Screenchart.

terminal 
npm start

Connect your AI provider

On first launch, pick a local CLI agent or enter an API key in settings. Full provider setup lives on the Execution mode setup page (coming next).

Troubleshooting

  • Wrong Node version: switch to the supported Node version listed above.
  • App won't launch on macOS (unsigned): open System Settings > Privacy & Security and click Open Anyway.
  • CLI agent not detected: make sure the CLI is installed and on your PATH, then rescan in settings.
  • Capture not working on macOS: grant Screen Recording permission in System Settings.

Next steps