sim-preview

sim-preview is a skill for Claude Code, Codex from K9i-0/ccpocket. It costs 92 tokens per session (1,384 once invoked), scanned A, original, MIT.

A workflow for viewing an iOS app running in an iPhone Simulator through VNC, a protocol for remotely seeing and controlling a screen. It uses TrollVNC and can expose the simulator through Tailscale.

In plain words
What is it for?
Use it to boot an iPhone Simulator, launch a Flutter app, start the VNC server, and connect from an iPhone or browser using the printed connection details.
Why use it?
It lets you check the app's screen and interactions remotely while making changes and using hot reload during development.

Skill for Claude CodeCodex

About the project

CC Pocket is a mobile and desktop client for controlling Codex and Claude coding-agent sessions through a self-hosted Bridge Server running on another computer. It lets users start sessions, approve actions, answer questions, review changes, and continue coding from supported devices. The catalogue entries provide the skills, hooks, MCP servers, agents, instructions, and settings used by this client.

K9i-0/ccpocket · 1,060 stars · on GitHub

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/k9i-0/ccpocket/sim-preview
Any agent
npx skills add K9i-0/ccpocket --skill sim-preview
Clone the repo
git clone --depth 1 https://github.com/K9i-0/ccpocket

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 sim-preview

README.md
[![agentmods](https://agentmods.dev/badge/skills/k9i-0/ccpocket/sim-preview.svg)](https://agentmods.dev/skills/k9i-0/ccpocket/sim-preview)
Your own site
<a href="https://agentmods.dev/skills/k9i-0/ccpocket/sim-preview"><img src="https://agentmods.dev/badge/skills/k9i-0/ccpocket/sim-preview.svg" alt="Measured on agentmods" height="20"></a>
Per session 92 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,384 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. 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.00092 $0.01384
Opus 5 $0.00046 $0.00692
Sonnet 5 $0.00018 $0.00277
Haiku 4.5 $0.00009 $0.00138

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

Security

Grade A, and why

sim-preview scanned grade A with 0 findings 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 5d ago.

The scan reads SKILL.md. This mod also ships 1 executable file (scripts/sim-preview.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.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/skills/sim-preview/SKILL.md · 123 lines

How it starts

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

Simulator Preview (TrollVNC)

iOSシミュレーターでアプリを起動し、TrollVNC でリモートプレビュー環境を提供する。 ユーザーは iPhone の VNC Viewer アプリ(RealVNC Viewer 推奨)から Tailscale 経由で接続し、シミュレーター画面をリアルタイムで確認・操作できる。

ワークフロー概要

iPhone (ユーザー)
  ├── ccpocket で Claude Code に指示
  ├── RealVNC Viewer でシミュレーター画面を確認
  └── 指示 → 変更 → hot reload → 目視確認 のループ

手順

1. アプリをビルド・起動

dart-mcp の launch_app でシミュレーターにアプリを起動する。 hot reload が使えるデバッグモードで起動される。

シミュレーターがまだ起動していない場合は、先にブートする:

# 利用可能なiPhoneシミュレーターを確認
xcrun simctl list devices available | grep iPhone

# 起動(UDIDを指定)
xcrun simctl boot <UDID>

起動済みのシミュレーターを確認:

xcrun simctl list devices booted

dart-mcp でアプリを起動:

  • root: プロジェクトの apps/mobile ディレクトリ
  • device に booted なシミュレーターの UDID を指定

2. TrollVNC 起動(スクリプト)

bash .claude/skills/sim-preview/scripts/sim-preview.sh

スクリプトが以下を行う:

  • シミュレーターの起動確認(未起動なら自動ブート)
  • trollvncserver バイナリをシミュレーターに配置
  • VNC サーバー起動(ポート 5901、スケール 0.75、ナチュラルスクロール、サーバーサイドカーソル)
  • Tailscale IP を検出して接続情報を出力

出力例:

SIMULATOR: <UDID>
VNC_PORT: 5901
LOCAL_VNC: vnc://127.0.0.1:5901
TAILSCALE_VNC: vnc://<tailscale-ip>:5901
NOVNC_URL: http://<tailscale-ip>:5801/novnc/vnc_lite.html?...

3. ユーザーへの案内

スクリプト出力の TAILSCALE_VNC を使って、以下の情報をユーザーに伝える:

  • VNC 接続先: TAILSCALE_VNC のアドレスとポート
  • 推奨アプリ: RealVNC Viewer(無料、スワイプ操作が自然)
  • 操作方法:
    • タップ: 1本指タップ
    • スワイプ: 1本指ドラッグ
    • ホームに戻る: マウスモードで2本指タップ(右クリック)
    • スクロール: 2本指スクロール
  • noVNC(ブラウザ): NOVNC_URL でも接続可能だが、アプリの方が操作性が良い

4. コード変更 → 確認ループ

コード変更後は dart-mcp の hot_reload でシミュレーターに即時反映される。 ユーザーは VNC Viewer で変化をリアルタイムに確認できる。

前提条件

  • ~/bin/trollvncserver: TrollVNC シミュレーター用バイナリ(ビルド済み)
  • Tailscale: Mac と iPhone の両方で接続済み
  • RealVNC Viewer: iPhone にインストール済み

TrollVNC のビルド方法(初回のみ)

バイナリが存在しない場合のビルド手順:

# Theos(未インストールの場合)
git clone --recursive https://github.com/theos/theos.git ~/theos

# TrollVNC クローン
git clone --depth 1 https://github.com/OwnGoalStudio/TrollVNC.git /tmp/TrollVNC

# シミュレーター向けビルド(シミュレーターを起動しておくこと)
cd /tmp/TrollVNC && THEOS=~/theos make THEOS_DEVICE_SIMULATOR=1

# バイナリを配置
mkdir -p ~/bin
cp /tmp/TrollVNC/.theos/obj/iphone_simulator/debug/trollvncserver ~/bin/
chmod +x ~/bin/trollvncserver

# noVNC webclients(オプション)
mkdir -p ~/bin/trollvnc-webclients
cp -R /tmp/TrollVNC/layout/usr/share/trollvnc/webclients/* ~/bin/trollvnc-webclients/

Read the full file on GitHub · 123 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. 5d ago First seen · 123 lines · 92 tokens per session scan A 584691b0eb1c

Subscribe to this mod's changes

sim-preview is a skill published in the GitHub repository K9i-0/ccpocket (1,060 stars, last pushed today), licensed MIT. It adds 92 tokens to every session and 1,384 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

flutter

Use when building, structuring, testing or optimizing a Flutter app — feature-first layering, Riverpod 3 or Bloc, typed gorouter, freezed models, a dio data layer, Material 3, jank hunting, widget/golden tests. Targets Flutter 3.44 / Dart 3.12. NOT React Native (that is react-native), NOT Compose Multiplatform (that…

ericrisco/rsc-harness · 91 tokens

zmr-mobile-testing

Use when testing mobile apps with Zeno Mobile Runner, integrating app-local .zmr setup, driving Android or iOS simulator scenarios, using JSON-RPC or MCP agent sessions, exporting traces, or comparing mobile runner benchmarks.

johnmikel/zeno-mobile-runner · 50 tokens

cloudx-integrate

Integrate the CloudX SDK into a publisher app on any supported platform (Android, iOS, React Native, Flutter, Unity). Use when asked to integrate, add, install, or set up CloudX, CloudX ads, or CloudX mediation in an app, including alongside or replacing an existing mediation stack such as AppLovin MAX, LevelPlay, or…

cloudx-io/cloudx-sdk-agents · 82 tokens

mobile-engineer

You are the Mobile Engineer Specialist — a cross-platform mobile development expert who builds performant, production-ready mobile applications. You specialize in React Native (Expo) and Flutter, with deep expertise in native integrations, offline-first architectures, and app store deployment.

buiphucminhtam/forgewright · 56 tokens

mobile

Mobile development with React Native, Flutter, and native patterns.

miles990/claude-software-skills · 13 tokens

android-e2e-readiness

Use when Android mobile E2E flows are flaky, Compose and View screens disagree with automation, hybrid screens are ambiguous, retries hide the real issue, or the team keeps collapsing the problem to selector-vs-timing without checking Android-specific readiness contracts.

shenyuexin/mobile-e2e-mcp · 57 tokens