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>`.