Cortask

Installation

Prerequisites

  • Node.js 20 or later
  • pnpm (install with npm install -g pnpm if you don't have it)

Clone and install

git clone https://github.com/cortask/cortask.git
cd cortask/app
pnpm install

Build

Build all packages (order matters -- core and channels must compile first):

pnpm run build

If you only need the runtime dependencies (no UI or CLI build):

pnpm run build:deps

This builds @cortask/core and @cortask/channels, which the gateway depends on.

Start the server

Development mode (builds deps, then starts gateway + UI with hot reload):

pnpm run dev

CLI (after building and linking):

pnpm run link-cli
cortask serve

Both methods start the gateway on http://127.0.0.1:3777 by default.

Verify it's running

Open your browser to http://localhost:3777. You should see the Cortask UI. If this is your first launch, the onboarding wizard will appear.

From the command line you can also confirm the server is up:

curl http://localhost:3777/api/health