Ii App
Apps & Automationii-appIi 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.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- 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 cacheii-app web restartto restart the cached tmux-backed web serversii-app web view-logto inspect web server outputii-app web screenshotto open the cached preview URL inagent-browser, save a screenshot, and print the file pathii-app web statusto save server log output and a screenshot snapshot to disk, then print the status file pathii-app web checkpointto runbun run build:local, clean transient build artifacts, and create a git checkpoint commitii-app web list-templatesto inspect bundled web template IDsii-app mobile init <project_name>to scaffold an Expo app and write a mobile cacheii-app mobile restartto restart the Expo dev server and refresh tunnel/LAN URLsii-app mobile view-logto inspect Expo outputii-app stripe register-webhookto create a Stripe webhook endpoint and writeSTRIPE_WEBHOOK_SECRETinto the project.env
Workflow
Resolve the skill root as the directory containing this SKILL.md.
- If
bin/ii-appis missing or stale, build it withscripts/build.sh. - Run the binary from the skill root or by absolute path.
- Prefer
--jsonwhen another agent step needs structured output. - 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.envweb init --host-url <suffix>emits preview URLs likehttps://3000-<suffix>web screenshot --annotatesaves an annotated screenshot with numbered labels fromagent-browserweb screenshot --screenshot-dir <dir>overrides the default screenshot output directoryweb screenshot --screenshot-format png|jpegand--screenshot-quality <0-100>map toagent-browser screenshotweb status --output-dir <dir>writes a.log, optional screenshot, and.jsonsummary, then prints the summary pathweb init --skip-installandmobile init --skip-installavoid dependency installationweb init --skip-startandmobile init --skip-startavoid starting tmux or Expo after setupmobile init --template tabs|blank|blank-typescriptchooses the Expo startermobile init --example with-reanimatedcreates from an official Expo example instead of a templatemobile init --no-tailwindskips NativeWind-related install stepsstripe register-webhook --event evt1,evt2overrides the default Stripe event setstripe register-webhookwrites onlySTRIPE_WEBHOOK_SECRETto.env; it does not print the secret in plain-text outputview-log --session <name>targets a specific tmux session--jsonis 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.