OpenParable
Skip to content
← Back to skills

Ii App

Apps & Automation
ii-app

Ii App is an Agent Skill for apps & automation published in the Intelligent-Internet/ii-agent repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Use this skill when you need to initialize or restart local web and mobile app projects through the bundled Rust `ii-app` CLI instead of calling MCP tools.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/Intelligent-Internet/ii-agent/blob/HEAD/src/ii_agent/settings/skills/builtin/ii-app/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/ii-app, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

ii-app Skill

Use this skill for local app lifecycle actions that should go through the bundled Rust CLI:

  • ii-app web init <template_id> to scaffold a bundled web template and write a web cache
  • ii-app web restart to restart the cached tmux-backed web servers
  • ii-app web view-log to inspect web server output
  • ii-app web screenshot to open the cached preview URL in agent-browser, save a screenshot, and print the file path
  • ii-app web status to save server log output and a screenshot snapshot to disk, then print the status file path
  • ii-app web checkpoint to run bun run build:local, clean transient build artifacts, and create a git checkpoint commit
  • ii-app web list-templates to inspect bundled web template IDs
  • ii-app mobile init <project_name> to scaffold an Expo app and write a mobile cache
  • ii-app mobile restart to restart the Expo dev server and refresh tunnel/LAN URLs
  • ii-app mobile view-log to inspect Expo output
  • ii-app stripe register-webhook to create a Stripe webhook endpoint and write STRIPE_WEBHOOK_SECRET into the project .env

Workflow

Resolve the skill root as the directory containing this SKILL.md.

  1. If bin/ii-app is missing or stale, build it with scripts/build.sh.
  2. Run the binary from the skill root or by absolute path.
  3. Prefer --json when another agent step needs structured output.
  4. Use workspace-local caches unless the user asks for a custom --cache-path.

Default cache locations:

<workspace>/.ii-app/web.json
<workspace>/.ii-app/mobile.json

Commands

"<skill-root>/bin/ii-app" web list-templates
"<skill-root>/bin/ii-app" web init <template_id> --project-name <name> --workspace <dir>
"<skill-root>/bin/ii-app" web restart --workspace <dir>
"<skill-root>/bin/ii-app" web view-log --workspace <dir>
"<skill-root>/bin/ii-app" web screenshot --workspace <dir>
"<skill-root>/bin/ii-app" web status --workspace <dir>
"<skill-root>/bin/ii-app" web checkpoint --workspace <dir> --project-directory <dir>
"<skill-root>/bin/ii-app" mobile init <project_name> --workspace <dir>
"<skill-root>/bin/ii-app" mobile restart --workspace <dir>
"<skill-root>/bin/ii-app" mobile view-log --workspace <dir>
"<skill-root>/bin/ii-app" stripe register-webhook --stripe-secret-key <sk_...> --endpoint-url <https-url> --project-directory <dir>

Useful flags:

  • web init --database-url <url> writes a project .env
  • web init --host-url <suffix> emits preview URLs like https://3000-<suffix>
  • web screenshot --annotate saves an annotated screenshot with numbered labels from agent-browser
  • web screenshot --screenshot-dir <dir> overrides the default screenshot output directory
  • web screenshot --screenshot-format png|jpeg and --screenshot-quality <0-100> map to agent-browser screenshot
  • web status --output-dir <dir> writes a .log, optional screenshot, and .json summary, then prints the summary path
  • web init --skip-install and mobile init --skip-install avoid dependency installation
  • web init --skip-start and mobile init --skip-start avoid starting tmux or Expo after setup
  • mobile init --template tabs|blank|blank-typescript chooses the Expo starter
  • mobile init --example with-reanimated creates from an official Expo example instead of a template
  • mobile init --no-tailwind skips NativeWind-related install steps
  • stripe register-webhook --event evt1,evt2 overrides the default Stripe event set
  • stripe register-webhook writes only STRIPE_WEBHOOK_SECRET to .env; it does not print the secret in plain-text output
  • view-log --session <name> targets a specific tmux session
  • --json is supported by every command

References

  • For web template IDs and mobile starter options, read references/template-ids.md.
  • For cache shapes and CLI output expectations, read references/cli-contract.md.