spawn-session

spawn-session is a skill for Claude Code, Codex from shimo4228/claude-harness. It costs 197 tokens per session (3,889 once invoked), scanned B, original, MIT.

A workflow for starting a detached Claude Code Remote Control session for another project. The new session appears in the Claude mobile app and in Herdr's session list; detached means it runs independently of the current session.

In plain words
What is it for?
Use it to launch a named session for a different project, such as from an iPhone, and make that session available for remote control.
Why use it?
It removes the need to access the Mac directly when you want to start a separate remote coding session. It also distinguishes this use from continuing an existing session or creating multiple sessions in the same repository.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/shimo4228/claude-harness/spawn-session
Any agent
npx skills add shimo4228/claude-harness --skill spawn-session
Clone the repo
git clone --depth 1 https://github.com/shimo4228/claude-harness

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for spawn-session

README.md
[![agentmods](https://agentmods.dev/badge/skills/shimo4228/claude-harness/spawn-session.svg)](https://agentmods.dev/skills/shimo4228/claude-harness/spawn-session)
Your own site
<a href="https://agentmods.dev/skills/shimo4228/claude-harness/spawn-session"><img src="https://agentmods.dev/badge/skills/shimo4228/claude-harness/spawn-session.svg" alt="Measured on agentmods" height="20"></a>
Per session 197 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,889 The whole file, excluding the scripts and references it only reads on demand.
Security scan B 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00197 $0.03889
Opus 5 $0.00098 $0.01945
Sonnet 5 $0.00039 $0.00778
Haiku 4.5 $0.00020 $0.00389

Measured 4d ago against content hash 89a6de516395, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade B, and why

spawn-session scanned grade B with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

The scan reads SKILL.md. This mod also ships 1 executable file (spawn.sh), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Reads agent configuration directoriesmediumAgent snooping

.claude/, .codex/, .gemini/ hold keys, settings and other credentials a mod has no legitimate need for.

- **Dispatch で足りる用件** → Cowork タブの Dispatch に投げると、開発作業なら **Code タブのセッション**が起きる(Dispatch バッジ付きでサイドバーに出る)。**`~/.claude` の設定系は読まれる** — personal skills in `~/.claude/skills/` は local session に効き、`~/.claude/settings.json` も D
skills/spawn-session/SKILL.md · 129 lines

How it starts

The opening of the file, as written. The whole thing — 129 lines — stays where its author put it; the contents beside it link to each section on GitHub.

spawn-session

生きている任意のセッションから、名前付き・detached な新しい Claude Code Remote Control セッションを Herdr 内に起動する。新セッションは自分の RC を登録するので Claude モバイルアプリのセッション一覧に出る。iPhone から Remote Control 越しに操作している最中に、Mac に触れず別プロジェクトのセッションを増やすのが主用途。Herdr の艦隊ビュー(サイドバー・agent status)にもそのまま並ぶ。

When to use

  • 新しいセッションが欲しい(多くは別プロジェクト用)でモバイルアプリ一覧に出したい
  • トリガー例: 「新しいセッション立てて」「AAP のセッション開いて」「spawn a session for X」/ /spawn-session [project]

When NOT to use

  • 既存の会話を続けたい → claude --continue / --resume
  • 現在のセッションの文脈を消したいだけ → /clear
  • 現在のセッションの model / effort 切替 → /model, --effort
  • 同じ repo で複数セッションが欲しいだけ → 公式 server mode(claude remote-control --spawn worktree --capacity N)で足りる。この skill は要らない
  • Dispatch で足りる用件 → Cowork タブの Dispatch に投げると、開発作業なら Code タブのセッションが起きる(Dispatch バッジ付きでサイドバーに出る)。~/.claude の設定系は読まれる — personal skills in ~/.claude/skills/ は local session に効き、~/.claude/settings.json も Desktop と共有される(設定が claude.ai 同期になるのは Cowork タブ側の skills / plugins / connectors であって Code セッションではない)。この skill を使う理由は設定の届き方ではなく、Desktop アプリが実行主体になり Herdr 艦隊ビューに並ばないことと、起こす repo をこちらが選べないこと(Dispatch が種別で振り分ける)。Pro/Max 限定で Team/Enterprise では使えない
  • cloud session(Claude Code on the web)→ Anthropic 側で実行されるので、ローカル FS / MCP / Herdr と無関係。手元の repo を触らせたいなら対象外

How it works

埋めているギャップは cwd の壁であって、セッション数の壁ではない(2026-08-01 に公式 docs で確認)。公式 Remote Control には server mode があり --spawn <same-dir|worktree|session> / --capacity <N>(既定 32)/ --[no-]create-session-in-dir1 プロセスから複数セッションを持てる。ただし server mode の全セッションはその server プロセスの cwd(= 1 repo)に縛られるsame-dir は cwd 共有、worktree はその repo の worktree。別プロジェクトのセッションを起こす手段が公式には無い。回避策: 生きている任意のセッションが Bash で別の claude --remote-control "<名前>" を、指定した repo の cwd で Herdr の pane 内に detached 起動する。新プロセスが自分の RC を登録し、アプリ一覧に出る。Herdr の persistent session(server)が pty を保持するので、Ghostty/SSH の切断や起動元セッションの終了後も生き残る。server が動いていなければ spawn.sh が headless server を自動起動する(tmux のサーバー自動起動と同等のセマンティクス)。

配置は repo 単位 workspace 運用に合わせる: 同じルート(cwd)の workspace が既にあればそこに新 tab、無ければ新 workspace を作成(workspace label は repo 名、表示名は tab label)。

Read the full file on GitHub · 129 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago First seen · 129 lines · 197 tokens per session scan B 89a6de516395

Subscribe to this mod's changes

spawn-session is a skill published in the GitHub repository shimo4228/claude-harness (2 stars, last pushed 5d ago), licensed MIT. It adds 197 tokens to every session and 3,889 once invoked, about $0.0010 per session on Opus 5. A static security scan graded it B with 1 finding (reads agent configuration directories). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

zod

Zod v4 best practices, patterns, and API guidance for schema validation, parsing, error handling, and type inference in TypeScript applications. Covers safeParse, object composition, refinements, transforms, codecs, branded types, v3→v4 migration, and testing schemas with Jest or Vitest. Baseline: zod ^4.3.0. Triggers…

anivar/zod-skill · 138 tokens

jest

Jest best practices, patterns, and API guidance for JavaScript/TypeScript testing. Covers mock design, async testing, matchers, timer mocks, snapshots, module mocking, configuration, and CI optimization. Baseline: jest ^30.0.0. Triggers on: jest imports, describe, it, test, expect, jest.fn, jest.mock, jest.spyOn…

anivar/jest-skill · 97 tokens

agent-adoption-triage

Five-question triage for routing AI work to the right architecture — script, algorithmic search, LLM workflow, or autonomous agentic loop — before any agent is built. Use when someone says "let's build an agent for X", when deciding whether a use case actually needs an autonomous agent, when reviewing an agent…

shimo4228/agent-adoption-triage · 143 tokens

zod-testing

Testing patterns for Zod schemas using Jest and Vitest. Covers schema correctness testing, mock data generation, error assertion patterns, integration testing with API handlers and forms, snapshot testing with z.toJSONSchema(), and property-based testing. Baseline: zod ^4.0.0. Triggers on: test files for Zod schemas…

anivar/zod-testing · 105 tokens

redux-saga

Redux-Saga best practices, patterns, and API guidance for building, testing, and debugging generator-based side-effect middleware in Redux applications. Covers effect creators, fork model, channels, testing with redux-saga-test-plan, concurrency, cancellation, and modern Redux Toolkit integration. Baseline: redux-saga…

anivar/redux-saga-skill · 109 tokens

redux-saga-testing

Write tests for Redux Sagas using redux-saga-test-plan, runSaga, and manual generator testing. Covers expectSaga (integration), testSaga (unit), providers, partial matchers, reducer integration, error simulation, and cancellation testing. Works with Jest and Vitest. Triggers on: test files for sagas…

anivar/redux-saga-testing · 104 tokens