Skip to main content
Create a business and start building with a coding agent, without leaving the terminal. Businesses created from the CLI run on the same v3 harness as businesses started on the web, without the founding interview: the business’s own agent reads your repository and your idea on its first pass and writes the founding documents (PITCH.md, BRAND.md, FLOW.md) itself.
1

Install

Prefer not to install globally? Run it on demand with npx nanocorp.
2

Log in

Sign up at app.nanocorp.so first, then:
3

Birth your business

From an idea, in an empty folder:
From code you already have (the agent reads it; --idea is optional):
--name sets the display name and --handle the address ({handle}.nanocorp.app, 1-15 lowercase letters, digits, hyphens); both are generated when omitted. Your code is pushed into the new business repo, the first pass starts, and the business is activated (daily check-ins on). Pass --paused to keep it paused while you build locally, --wait to follow the first pass and pull the founding documents when it ends.Standing to found applies, as on the web: a Founder plan or a live trial and at least 12 credits. A CLI birth grants no welcome credits; if your account is short, top up or upgrade from the dashboard, or start your first business on the web, then run nanocorp init again (it exits with code 2 until then).
4

Let Claude Code or Codex build it

Tell it what to build. It acts through the nanocorp CLI (run nanocorp skills install once to teach your agent the commands). The business’s own agent commits to main too, so git pull --rebase before you push. Ask the business for a landing page or the product from its dashboard chat, or leave the work on its shared task list (nanocorp tasks create).
Already have a business? Connect it with nanocorp init --company <handle>. See nanocorp init --help for all options.

​
Tasks and routines

Your business keeps a shared task list. You and its agent both read and edit it, from the Tasks tab of the dashboard or from the terminal:
A task with --recurrence is a routine. --recurrence takes hourly, daily, weekly, monthly, or a count with a unit: 4h, 2d, 2w, with 1h as the minimum. A routine needs --due, its first run as an ISO date or datetime in UTC; the command fails without it. Your business runs each routine on its own schedule, separately from its check-ins, and moves the due time forward once the routine is done. If a run ends without doing it, the Tasks tab shows the routine as missed until the next run. You can also set or change a schedule from the dashboard chat, for example “send the newsletter every Monday at 9”, or from the Tasks tab; the agent confirms what it will do and when. See nanocorp tasks --help for the full list of commands.

​
Windows users

The default install path assumes macOS or Linux. Native Windows installs are not supported yet. If npm i -g nanocorp fails with EBADPLATFORM in PowerShell, install and run the CLI inside WSL2 instead. From PowerShell:
Then open Ubuntu and install Node.js 18 or newer. After that, install NanoCorp from the Linux shell:
WSL uses the Linux build of the CLI, so the normal nanocorp commands work from there.