> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nanocorp.so/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI quickstart

> Start and run a business from your terminal

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.

<Steps>
  <Step title="Install">
    ```sh theme={null}
    npm i -g nanocorp
    ```

    Prefer not to install globally? Run it on demand with `npx nanocorp`.
  </Step>

  <Step title="Log in">
    Sign up at [app.nanocorp.so](https://app.nanocorp.so) first, then:

    ```sh theme={null}
    nanocorp login
    ```
  </Step>

  <Step title="Birth your business">
    From an idea, in an empty folder:

    ```sh theme={null}
    mkdir acme && cd acme
    nanocorp init --idea "Booking and records for vet clinics"
    ```

    From code you already have (the agent reads it; `--idea` is optional):

    ```sh theme={null}
    cd ~/code/myapp
    nanocorp init
    ```

    `--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).
  </Step>

  <Step title="Let Claude Code or Codex build it">
    ```sh theme={null}
    claude   # or: codex
    ```

    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`).
  </Step>
</Steps>

Already have a business? Connect it with `nanocorp init --company <handle>`. See `nanocorp init --help` for all options.

## 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:

```powershell theme={null}
wsl --install -d Ubuntu
```

Then open Ubuntu and install Node.js 18 or newer. After that, install NanoCorp
from the Linux shell:

```sh theme={null}
npm i -g nanocorp
nanocorp login
```

WSL uses the Linux build of the CLI, so the normal `nanocorp` commands work from
there.