Cortask

Quick Start

This guide assumes you have already completed the installation steps.

1. Start the server

pnpm run dev

2. Open the UI

Navigate to http://localhost:3777 in your browser.

3. Complete onboarding

On first launch the onboarding wizard walks you through four steps:

  1. Pick a provider -- choose from Anthropic, OpenAI, Google Gemini, and others.
  2. Enter your API key -- the key is validated with a test request and then stored in the encrypted credential store.
  3. Select a model -- a sensible default is pre-filled (e.g. claude-sonnet-4-5-20250929 for Anthropic, gpt-4o for OpenAI).
  4. Set a workspace directory -- this is the default working directory the agent will operate in.

4. Send your first message

Once onboarding is complete you land on the chat page. Type a message and press Enter. The agent will respond using the provider you configured.

5. Try a skill

Skills are packaged prompts and tool configurations that give the agent specialised abilities. Open the skills panel in the UI to browse available skills, then mention one in your message to activate it.

CLI alternative

If you prefer the terminal, the CLI offers the same functionality:

# Start an interactive chat session
cortask chat

# Chat with a specific workspace
cortask chat -w /path/to/project

Run cortask --help to see all available commands.