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

Path A — VS Code + Claude Code

Powered by Anthropic’s Claude. Commands use /skill-name syntax.

Path B — Codex

Powered by OpenAI. Commands use $skill-name syntax.
Both paths read the same files and run the same system. The only difference is the command prefix.
While Claude Code requires a paid subscription, Codex is available to ChatGPT Free and Go users for a limited time.

​
Path A: VS Code and Claude Code

​
What you need

VS Code

Free code editor where you run Signal OS.

Claude Code

VS Code extension that powers the skills. Requires a Claude subscription (Pro or above).

Obsidian

Free writing app where your articles live. Signal OS creates files here automatically.

​
Setup steps

1

Download and unzip Signal OS

Download the Signal OS Social folder here.Once downloaded, unzip the file — you’ll get a folder called signal-os-social. Move it anywhere you like (Desktop or Downloads works fine).
2

Install VS Code

  1. Go to 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
3

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.
4

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
5

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 if you don’t have one
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.
6

Install Obsidian

  1. Go to 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.
7

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.
If you ever get lost, type /social-help to see exactly where you are and what to do next.

​
Path B: Codex

The Codex app is currently Mac only. If you’re on Windows, use Path A (VS Code + Claude Code) instead.

​
What you need

Codex app

The Mac desktop app. Available free to ChatGPT Free and Go users for a limited time.

Obsidian

Free writing app where your articles live. Signal OS creates files here automatically.

​
Setup steps

1

Download and unzip Signal OS

Download the Signal OS Social folder here.Once downloaded, unzip the file — you’ll get a folder called signal-os-social. Move it anywhere you like (Desktop or Downloads works fine).
2

Download the Codex app

  1. Go to openai.com/codex and sign in with your OpenAI account
  2. Download and install the Mac desktop app
3

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
4

Install Obsidian

  1. Go to 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.
5

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.
If you ever get lost, type $social-help to see where you are and what to do next.

​
What happens after setup

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

Authority content

You did something onchain — document it.
/social-doc → /social-result → /social-reflect

Growth content

You have a take or a story to tell.
/social-idea → /social-outline → [write in Obsidian]
→ /social-review → /social-cta
→ /social-publish → /social-tweets
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.

​
Optional: Connect Typefully

Typefully lets you schedule tweets, CTAs, and cross-posts to X, Threads, BlueSky, and LinkedIn from one place. Once you have a Typefully account, run: 
/typefully-api-install
It will walk you through connecting your account step by step.
On Codex, use $typefully-api-install instead.

Skills reference

Browse all Signal OS skills, their invocation syntax for Claude Code and Codex, and how they fit into each content workflow.