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

# Installation

> Get Signal OS Social running from scratch — no coding experience required.

Signal OS runs inside an AI coding agent on your computer. Pick the path that matches the agent you use.

<CardGroup cols={2}>
  <Card title="Path A — VS Code + Claude Code" icon="code" href="#path-a-vs-code-and-claude-code">
    Powered by Anthropic's Claude. Commands use `/skill-name` syntax.
  </Card>

  <Card title="Path B — Codex" icon="openai" href="#path-b-codex">
    Powered by OpenAI. Commands use `$skill-name` syntax.
  </Card>
</CardGroup>

Both paths read the same files and run the same system. The only difference is the command prefix.

<Note>
  While Claude Code requires a paid subscription, Codex is available to ChatGPT Free and Go users for a limited time.
</Note>

***

## Path A: VS Code and Claude Code

### What you need

<CardGroup cols={2}>
  <Card title="VS Code" icon="window" href="https://code.visualstudio.com/">
    Free code editor where you run Signal OS.
  </Card>

  <Card title="Claude Code" icon="robot" href="https://claude.ai">
    VS Code extension that powers the skills. Requires a Claude subscription (Pro or above).
  </Card>

  <Card title="Obsidian" icon="notebook" href="https://obsidian.md/">
    Free writing app where your articles live. Signal OS creates files here automatically.
  </Card>
</CardGroup>

***

### Setup steps

<Steps>
  <Step title="Download and unzip Signal OS">
    [Download the Signal OS Social folder here.](https://fipcrypto.gumroad.com/l/signal-os-social)

    Once downloaded, unzip the file — you'll get a folder called `signal-os-social`. Move it anywhere you like (Desktop or Downloads works fine).
  </Step>

  <Step title="Install VS Code">
    1. Go to [code.visualstudio.com](https://code.visualstudio.com/)
    2. Click the download button for your operating system
    3. Open the downloaded file and follow the installation steps
    4. Open VS Code once installed
  </Step>

  <Step title="Open the Signal OS folder in VS Code">
    1. In VS Code, click **File → Open Folder**
    2. Navigate to the `signal-os-social` folder you just unzipped
    3. Click **Open**

    You are now inside your Signal OS folder.
  </Step>

  <Step title="Install the Claude Code extension">
    1. Click the **Extensions** icon in the left sidebar (four squares icon)
    2. Search for `Claude Code`
    3. Click **Install** on the Claude Code extension by Anthropic
    4. Once installed, a Claude icon will appear in the left sidebar
  </Step>

  <Step title="Sign in to Claude Code">
    1. Click the Claude icon in the VS Code sidebar
    2. Click **Sign in** and follow the prompts to connect your Claude account
    3. You need an active Claude subscription (Pro or above) — sign up at [claude.ai](https://claude.ai) if you don't have one

    <Tip>
      Use **Haiku** as your model instead of Sonnet. It's faster, uses less of your rate limit, and handles Signal OS skills just as well for day-to-day use.
    </Tip>
  </Step>

  <Step title="Install Obsidian">
    1. Go to [obsidian.md](https://obsidian.md/) and download the app
    2. Open Obsidian
    3. On the welcome screen, click **Open folder as vault**
    4. Navigate to the same `signal-os-social` folder and click Open

    Your Signal OS folder will appear in Obsidian's sidebar. This is where you'll read and write your articles — it's much easier to work in than raw markdown files.
  </Step>

  <Step title="Run your first skill">
    1. Go back to VS Code — the Claude Code panel should be visible on the left
    2. Click on it to open the chat
    3. Type `/social-start` and press Enter

    This is the system entry point. It loads Signal OS, checks the state of your repo, and tells you exactly what to do first. If you're brand new, it will walk you through four quick wins to get you up and running.

    <Tip>
      If you ever get lost, type `/social-help` to see exactly where you are and what to do next.
    </Tip>
  </Step>
</Steps>

***

## Path B: Codex

<Warning>
  The Codex app is currently **Mac only**. If you're on Windows, use Path A (VS Code + Claude Code) instead.
</Warning>

### What you need

<CardGroup cols={2}>
  <Card title="Codex app" icon="openai" href="https://openai.com/codex">
    The Mac desktop app. Available free to ChatGPT Free and Go users for a limited time.
  </Card>

  <Card title="Obsidian" icon="notebook" href="https://obsidian.md/">
    Free writing app where your articles live. Signal OS creates files here automatically.
  </Card>
</CardGroup>

***

### Setup steps

<Steps>
  <Step title="Download and unzip Signal OS">
    [Download the Signal OS Social folder here.](https://fipcrypto.gumroad.com/l/signal-os-social)

    Once downloaded, unzip the file — you'll get a folder called `signal-os-social`. Move it anywhere you like (Desktop or Downloads works fine).
  </Step>

  <Step title="Download the Codex app">
    1. Go to [openai.com/codex](https://openai.com/codex) and sign in with your OpenAI account
    2. Download and install the Mac desktop app
  </Step>

  <Step title="Open Signal OS in Codex">
    1. In Codex, click **Add new project**
    2. Navigate to the `signal-os-social` folder you just unzipped and select it
    3. Click **Open** — Codex will read the `AGENTS.md` file at the root of the folder, which tells it how Signal OS works
  </Step>

  <Step title="Install Obsidian">
    1. Go to [obsidian.md](https://obsidian.md/) and download the app
    2. Open Obsidian
    3. On the welcome screen, click **Open folder as vault**
    4. Navigate to the same `signal-os-social` folder and click Open

    This is where you'll read and write your articles — much easier than working in raw markdown files.
  </Step>

  <Step title="Run your first skill">
    In the Codex chat, type:

    ```
    $social-start
    ```

    This is the system entry point — it loads Signal OS, checks the state of your folder, and tells you exactly what to do first.

    <Tip>
      If you ever get lost, type `$social-help` to see where you are and what to do next.
    </Tip>
  </Step>
</Steps>

***

## What happens after setup

Once your `NORTHSTAR.md` is filled in, you have two paths for creating content:

<CardGroup cols={2}>
  <Card title="Authority content" icon="link-chain">
    You did something onchain — document it.

    ```
    /social-doc → /social-result → /social-reflect
    ```
  </Card>

  <Card title="Growth content" icon="chart-line">
    You have a take or a story to tell.

    ```
    /social-idea → /social-outline → [write in Obsidian]
    → /social-review → /social-cta
    → /social-publish → /social-tweets
    ```
  </Card>
</CardGroup>

<Note>
  Not sure which to start with? Run `/social-help` (or `$social-help` on Codex) — it scans your folders and tells you exactly what to do next.
</Note>

***

## Optional: Connect Typefully

[Typefully](https://typefully.com/?via=fipcrypto) lets you schedule tweets, CTAs, and cross-posts to X, Threads, BlueSky, and LinkedIn from one place.

Once you have a [Typefully](https://typefully.com/?via=fipcrypto) account, run:

```
/typefully-api-install
```

It will walk you through connecting your account step by step.

<Note>
  On Codex, use `$typefully-api-install` instead.
</Note>

<Card title="Skills reference" icon="list" href="/signal-os/skills">
  Browse all Signal OS skills, their invocation syntax for Claude Code and Codex, and how they fit into each content workflow.
</Card>