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

# CLI Overview

> Deploy your app from the terminal in one command with the nom CLI.

The `nom` CLI is the fastest way to get your app live from your terminal. No dashboards, no clicking around -- just three commands and your app is running on real infrastructure.

## Who is this for?

If you like working in a terminal (or if an AI coding tool like Cursor or Claude Code is writing your code), the CLI is for you. It works great on its own, and it also powers the [MCP server](/cli/mcp-server) that lets AI tools deploy directly.

## Install

```bash theme={null}
npm install -g @nometria-ai/nom
```

<Info>
  Requires Node.js 18 or newer. You can also use `npx @nometria-ai/nom` without installing globally.
</Info>

## Three commands to go live

<Steps>
  <Step title="Sign in">
    ```bash theme={null}
    nom login
    ```

    This opens your browser so you can sign in with Google, GitHub, or email. No tokens to copy-paste.
  </Step>

  <Step title="Set up your project">
    ```bash theme={null}
    nom init
    ```

    This detects your framework (Next.js, Vite, Remix, etc.) and creates a `nometria.json` config file.
  </Step>

  <Step title="Deploy">
    ```bash theme={null}
    nom deploy
    ```

    Your app is built, uploaded, and deployed to AWS. You get a live URL in about two minutes.
  </Step>
</Steps>

That's it. Your app is live.

## What else can it do?

The CLI has 16 commands that cover everything you need after that first deploy:

<CardGroup cols={2}>
  <Card title="Staging previews" icon="eye" href="/cli/commands#preview">
    Run `nom preview` to get a free staging URL that expires in 2 hours. Great for testing before you go live.
  </Card>

  <Card title="GitHub auto-deploy" icon="github" href="/cli/github-integration">
    Connect GitHub and every push to `main` triggers a new deploy automatically.
  </Card>

  <Card title="AI tool integration" icon="wand-magic-sparkles" href="/cli/ai-tools-setup">
    Run `nom setup` to generate 12 config files for Cursor, Claude Code, Copilot, Cline, Windsurf, and more.
  </Card>

  <Card title="Claude Code slash commands" icon="terminal" href="/cli/slash-commands">
    Type `/deploy` in Claude Code to deploy. Also `/preview`, `/status`, and `/nometria-login`.
  </Card>

  <Card title="MCP server" icon="plug" href="/cli/mcp-server">
    Let Claude Code deploy, check status, and manage your app using natural language.
  </Card>
</CardGroup>

## Next steps

<CardGroup cols={2}>
  <Card title="Installation and setup" icon="download" href="/cli/install">
    Detailed install instructions, login options, and environment variables.
  </Card>

  <Card title="Command reference" icon="book" href="/cli/commands">
    Every command with examples and options.
  </Card>

  <Card title="AI tools setup" icon="robot" href="/cli/ai-tools-setup">
    Generate config files so every AI coding tool knows how to deploy your project.
  </Card>

  <Card title="GitHub integration" icon="code-branch" href="/cli/github-integration">
    Auto-deploy on push and GitHub Actions setup.
  </Card>
</CardGroup>