Grok Multi-Thread HEOS SOP

Problem: Codex’s app gives a left-rail of threads (e.g. “Start CEO OS day”, “CBS electronic badge”, “Anne transition”). Grok Build is terminal-first — it can feel like “one window, one chat.”

Answer: Grok already has sessions (saved per working directory). The SOP is /new + /rename + /resume + /dashboard, optional multi-tab terminals, and the same “one thread = one job” hygiene you already use in Codex.

This page is the living playbook for running HEOS (and similar repos) with Grok Build when Codex quota is tight or you prefer Grok’s terminal workflow.

Codex threads vs Grok sessions

Sessions live on disk under ~/.grok/sessions/<encoded-cwd>/<session-id>/, so HEOS work stays grouped by the empire OS repo path — same project-scoped idea as Codex’s project threads.

Recommended setups (ranked)

1. One Grok process + Dashboard (default)

1. cd into the Headless Empire OS repo (or whatever vault you’re operating).
2. Run grok.
3. For each job: /new → /rename … → work.
4. Switch with /dashboard (Ctrl+\) or /resume.

Closest mental model to the Codex left rail. You do not need Cursor just to get multiple threads.

2. Multiple terminal tabs (parallel work)

One tab = one live named session:

Tab 1:  grok  →  /rename Start CEO OS day
Tab 2:  grok  →  /rename CBS electronic badge
Tab 3:  grok  →  /rename Anne transition handover

Git caution: two agents editing the same files can thrash. For parallel code/docs in one repo, prefer sequential sessions, or /fork --worktree / separate worktrees when isolation matters.

3. Cursor + Grok (optional hybrid)

Naming convention (match Codex habits)

Name sessions like tasks, not like vibes:

• Start CEO OS day
• HEOS Marketing MBNOW024
• Add CBS electronic badge task
• HEOS Idea Processing - 2026-08-05
• Document Anne transition handover

/rename Start CEO OS day
/rename CBS electronic badge
/rename HEOS Idea Processing - 2026-08-05

Then the session list is your Codex sidebar. Resume by title: grok --resume "Start CEO OS day" (title match is case-insensitive for the current directory).

HEOS day recipe

1. Open the vault: terminal in Headless Empire OS repo → grok.
2. Morning hub thread: /new → /rename Start CEO OS day → paste Big 3 / priorities (marketing, people ops, idea processing, etc.).
3. Spawn sub-jobs as new sessions when context would mix (badge vs Anne vs Bangkok vs SEO). Don’t stack unrelated outcomes in the day thread.
4. Bounded idea dumps: /new → /rename HEOS Idea Processing - YYYY-MM-DD → route conclusions back into the vault (TODAY / NOW / projects), then stop that thread.
5. End of day: leave sessions as-is (they’re saved). Tomorrow /resume the day hub or start a fresh day thread — don’t revive a 40-turn mess if a clean day is clearer.
6. Vault residue: every finished thread should leave files in HEOS (NOW, TODAY, project notes). If it didn’t write to the vault, it was chat theater.

Same spirit as Office structure (one system, named skills, accountability) and graph engineering (one job per node — here, one job per session).

When to split a thread

Context hygiene

• /compact — reclaim window space; pass a note of what to keep.
• Auto-compact — Grok can compact near context limits; still prefer short threads.
• /session-info — check usage mid-day.
• Don’t mix tools’ limits — Codex quota ≠ Grok quota; switch tools without merging threads into one mega-chat.

Git & parallel agents

• One active session editing HEOS command-center files is usually enough for “CEO OS day.”
• Parallel tabs: assign non-overlapping paths (e.g. one session only marketing project, one only people ops).
• For experimental branches: /fork --worktree when isolation beats speed.
• After multi-session days: one human git status / review before big pushes.

Quick command card

/new                         # new thread
/rename My thread title      # Codex-style name
/resume                      # pick past thread
/dashboard                   # live multi-session board (Ctrl+\)
/fork                        # branch history (± worktree)
/home                        # back to welcome / switch
/compact keep vault paths    # shrink context
/session-info                # status

# CLI
grok
grok --resume
grok --resume "Start CEO OS day"
grok dashboard

Details evolve with Grok Build releases — see local user guide under ~/.grok/docs/user-guide/ (sessions, dashboard, slash commands) if a flag changes.

Direct answers

Related

Living notes

Update when Grok Build dashboard/session UX changes, or when we settle a fixed HEOS thread taxonomy (e.g. always prefix HEOS · / CBS · / GFA ·).