> ## 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 company from your terminal

Create a company and start building with a coding agent, without leaving the terminal.

<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="Create your company">
    ```sh theme={null}
    mkdir acme && cd acme
    nanocorp init --name acme --one-liner "AI for vets"
    ```

    The name is also the handle (1-15 lowercase letters, digits, hyphens). Your
    company starts paused, so nothing runs until you start it.
  </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). Start the company
    from the [dashboard](https://app.nanocorp.so) when you want it running on its
    own.
  </Step>
</Steps>

Already have a company? 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.