spawn-instance

Materialize and launch aweb agent instances with isolated git worktrees using one aw CLI command.

82|9|Updated Feb 2, 2026
One-click install
npx skills add https://github.com/awebai/aweb --skill spawn-instance-awebai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spawn-instance
Source: https://github.com/awebai/aweb/tree/main/.agents/skills/spawn-instance
Command: npx skills add https://github.com/awebai/aweb --skill spawn-instance-awebai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Adding a new AI teammate to an aweb team normally requires a manual sequence of invite, accept, init, symlink, and git worktree setup steps. This Skill condenses that entire workflow into a single aw team admin add --start command that materializes the instance home, configures worktree isolation, and launches the runtime. ## Core Features & Use Cases - One-command spawning: aw team admin add <name>@aweb.team/<role>=<runtime> --start materializes the home from a blueprint profile, sets up the isolated git worktree, and launches the runtime in tmux. - Two-step staging: Drop --start to materialize the home first and launch later with aw team admin up, useful when you want the environment staged before running. - Safe session handling: Named tmux sessions with --no-attach, refusal to recreate sessions holding live agent windows, and an explicit --force-kill override. - Use Case: A coordinator agent is assigned work that needs a reviewer. It runs the spawn command with the reviewer blueprint profile and claude-code runtime, then verifies with aw workspace status that the new member is active. ## Quick Start Ask the agent to spawn a new teammate by running aw team admin add with the desired name, role, runtime, and the --start flag from its own instance home.

Frequently Asked Questions about spawn-instance

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a new agent teammate to an aweb team?▼

Run `aw team admin add <name>@aweb.team/<role>=<runtime> --start` from your own instance home. This single command materializes the home from a blueprint profile, sets up the isolated git worktree, and launches the runtime in tmux.

How to stage an aweb instance home without launching it?▼

Drop the `--start` flag from `aw team admin add` to only materialize the home and set up worktree isolation. Launch it later with `aw team admin up`, which uses the same launch path.

What runtimes does aweb instance spawning support?▼

The spawn command supports `claude-code` and `pi` runtimes, specified as `<role>=<runtime>` in the address. Launch includes channel preflight, trust prompt auto-answering, and `pi --approve` for the pi runtime.

Why does aw team admin add refuse to recreate a tmux session?▼

The `--recreate` option is refused when the target session holds running agent windows to protect live teammates. Use a fresh throwaway `--session` name instead, or `--force-kill` as the explicit override.

Can I move or rename an aweb instance home after creation?▼

No. aweb registers the instance identity at its materialized path, so moving or renaming the home breaks the identity registration. Choose the path carefully with `--home` or accept the default `agents/instances/<name>`.