Quickstart

Everything you need to go from zero to running AI containers on your own hardware.

1. Install the CLI

npm config set @crops-code:registry https://npm.pkg.github.com
npm install -g @crops-code/cli
cropscode --version

Requires Node.js 22+. See Install CLI for details.

2. Log in

cropscode login

This opens your browser for a secure OAuth sign-in with your CropsCode account.

3. Start a worker

cropscode worker

On first run, the CLI walks you through tenant selection and then starts the worker daemon. The worker connects outbound to the orchestrator — no inbound ports, no firewall rules.

Or run the guided wizard that handles everything (login, tenant selection, runtime checks):

cropscode onboard

4. Launch your first container

1. Open the dashboard at your orchestrator URL
2. Paste a GitHub issue link into the launch modal
3. Pick a worker and click Launch

Within 30 seconds, a container is running and the web terminal is live. Your AI agent is now working on the ticket.

What’s next?

• Launch from a ticket — full walkthrough of the launch flow
• Workers concept — understand self-hosted vs managed
• CLI reference — all available commands