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

# Quickstart

> Get OrgX running and your first agent working in under 10 minutes.

## Prerequisites

Before you begin, make sure you have:

<Check>
  A shell or MCP-capable client where you can run `npx`, MCP commands, or pair a
  browser session
</Check>

<Check>
  An OrgX account (public beta) at [useorgx.com](https://useorgx.com)
</Check>

<Check>
  Optional: GitHub, Linear, or other tools you want OrgX to sync after setup
</Check>

## Step 1: Create Your Account

<Steps>
  <Step title="Sign Up">
    Visit [useorgx.com/sign-up](https://useorgx.com/sign-up) and create your
    account using email or Google OAuth.
  </Step>

  <Step title="Complete Onboarding">
    The onboarding wizard will guide you through:

    * Setting your first goal or initiative
    * Watching agents build your canvas in real time
    * Choosing where you want to work first
  </Step>
</Steps>

## Step 2: Choose Your First Surface

Start in the surface that matches how you want to work today:

<CardGroup cols={2}>
  <Card title="Wizard CLI (Recommended)" icon="terminal" color="#14B8A6">
    **Status: Live** One-line onboarding that detects local surfaces, opens
    browser auth, and bootstraps your workspace. [Run the Wizard CLI
    →](/docs/guides/wizard-cli-onboarding)
  </Card>

  <Card title="OpenClaw Plugin (Recommended)" icon="plug" color="#BFFF00">
    **Status: Live** Recommended first integration. Browser pairing onboarding,
    automatic MCP config, and live OrgX dashboard in OpenClaw. [Set up OpenClaw
    →](/docs/guides/openclaw-plugin-setup)
  </Card>

  <Card title="GitHub" icon="github" color="#24292F">
    **Status: Beta** Optional OAuth for repo access. Agents can open PRs and
    comment on issues. [Connect GitHub →](/docs/guides/integrations#github)
  </Card>

  <Card title="Linear" icon="check-circle" color="#5E6AD2">
    **Status: Live** Optional OAuth integration for teams already managing
    projects and issues in Linear. [Connect Linear
    →](/docs/guides/integrations#linear)
  </Card>

  <Card title="Slack" icon="slack" color="#E01E5A">
    **Status: Coming Soon** Bot integration for blockers detection and team
    notifications.
  </Card>

  <Card title="Notion" icon="book" color="#000000">
    **Status: Coming Soon** Database sync for briefs and documentation.
  </Card>
</CardGroup>

## Step 3: Create Your First Initiative

An **initiative** is a goal that agents will work toward. OrgX uses the **IWMT hierarchy** (Initiative → Workstream → Milestone → Task) to automatically break down and execute work.

<Tabs>
  <Tab title="Via Mission Control">
    1. Open Mission Control from the dashboard
    2. Click **"New Initiative"**
    3. Describe your goal (e.g., "Launch v2 marketing site")
    4. OrgX will automatically:
       * Scaffold the full IWMT hierarchy (workstreams, milestones, tasks)
       * Begin auto-continue cascade execution
       * Surface decisions as agents work through tasks
  </Tab>

  <Tab title="Via ChatGPT">
    If you've connected the [ChatGPT integration](/docs/guides/chatgpt-integration):

    ```
    "Create an initiative to redesign our pricing page"
    ```

    OrgX will scaffold the full initiative hierarchy and begin execution.
  </Tab>

  <Tab title="Via MCP Clients">
    Use the `scaffold_initiative` tool to create a full hierarchy in one call:

    ```json theme={"dark"}
    {
      "tool": "scaffold_initiative",
      "args": {
        "title": "Q1 Product Launch",
        "summary": "Ship new dashboard features by end of quarter",
        "workstreams": [
          { "title": "Frontend", "tasks": [{ "title": "Build hero section" }] }
        ],
        "milestones": [{ "title": "Beta launch", "due_date": "2026-04-01" }]
      }
    }
    ```
  </Tab>
</Tabs>

## Step 4: Review Your First Decision

Once agents start working, they'll surface **decisions** that need your approval.

Each decision includes:

* **Context**: What the agent found and why it's asking
* **Recommendation**: The agent's suggested action
* **Evidence**: Links to issues, PRs, docs, or other sources
* **Actions**: Approve, Reject, or Request Changes

<Tip>
  Start with tighter approval settings, then loosen autonomy as you build trust
  with the agents.
</Tip>

## Step 5: Watch Artifacts Ship

Approved decisions become **artifacts**—the tangible outputs of agent work:

| Artifact Type | Example                               |
| ------------- | ------------------------------------- |
| Spec          | Product requirements document         |
| PR            | GitHub pull request with code changes |
| Brief         | Marketing campaign outline            |
| Report        | Research findings with citations      |
| Sequence      | Sales outreach emails                 |

Every artifact includes:

* Full agent reasoning chain
* Source citations
* Verifier proof (automated quality check)

## Optional: Connect Additional Surfaces

<AccordionGroup>
  <Accordion title="Wizard CLI" icon="terminal">
    Start from a single command that pairs OrgX in the browser, detects
    installed clients, and bootstraps your workspace automatically. [Run the
    Wizard CLI →](/docs/guides/wizard-cli-onboarding)
  </Accordion>

  {' '}

  <Accordion title="OpenClaw Plugin" icon="plug">
    Connect OrgX directly in OpenClaw with secure browser pairing and automatic
    first sync. [Set up OpenClaw plugin →](/docs/guides/openclaw-plugin-setup)
  </Accordion>

  {' '}

  <Accordion title="ChatGPT Integration" icon="comments">
    Give ChatGPT shared organizational memory, approval workflows, and project
    status through OrgX MCP. [Set up ChatGPT →](/docs/guides/chatgpt-integration)
  </Accordion>

  <Accordion title="MCP Clients" icon="code">
    Connect OrgX from ChatGPT, Cursor, Claude, VS Code, and other compatible
    clients. [Set up MCP →](/docs/guides/cursor-mcp-setup)
  </Accordion>

  <Accordion title="macOS Menu Bar" icon="apple">
    Quick access to decisions and agent status from your menu bar. *Coming soon*
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Understand Agents" icon="robot" href="/docs/platform/agents">
    Learn about each agent type and their capabilities.
  </Card>

  <Card title="Configure Autonomy" icon="sliders" href="/docs/platform/decisions">
    Dial in how much agents can do without asking.
  </Card>

  <Card title="MCP Reference" icon="server" href="/docs/api/mcp-tools">
    Full API reference for all MCP tools.
  </Card>

  <Card title="Security & Privacy" icon="shield" href="/docs/resources/security">
    How we handle your data and secrets.
  </Card>
</CardGroup>