gc-agents

Managing agents — list, peek, nudge, suspend, drain

Quality

67%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./internal/bootstrap/packs/core/skills/gc-agents/SKILL.md

Agent Management

Agents are the workers in a Gas City workspace. Each runs in its own session (tmux pane, container, etc).

Adding agents

gc agent add --name <name>             # Scaffold agents/<name>/prompt.template.md
gc agent add --name <name> --dir <rig> # Scaffold a rig-scoped agent.toml
gc agent add --name <name> --prompt-template <file>

Sessions from templates

Every configured template can now spawn sessions directly.

For cities migrating off the old multi-instance model, see engdocs/archive/migrations/remove-agent-multi-migration.md.

Use the session commands directly:

gc session new <template>              # Create and attach to a new session
gc session new <template> --no-attach  # Create a detached background session
gc session suspend <id-or-template>    # Suspend a session
gc session close <id-or-template>      # Close a session permanently
gc session kill <name>                 # Force-kill an agent session
gc session nudge <name> <message...>   # Send text to a running agent session
gc session logs <name>                 # Show session logs for an agent

When multiple sessions exist for the same template, use the session ID.

Pools

Pools still control controller-managed worker capacity. Pool max limits pool-managed workers, not manually created interactive sessions.

Lifecycle

gc agent suspend <name>                # Suspend agent (reconciler skips it)
gc agent resume <name>                 # Resume a suspended agent

Runtime

gc runtime drain <name>                # Signal agent to wind down gracefully
gc runtime undrain <name>              # Cancel drain
gc runtime drain-check <name>          # Check if agent has been drained
gc runtime drain-ack <name>            # Acknowledge drain (agent confirms exit)
gc runtime request-restart             # Request graceful restart (reads GC_AGENT env)

Repository: crypt0nerd1/gascity
Path: internal/bootstrap/packs/core/skills/gc-agents/SKILL.md
Commit: f530008

Last updated: 1 day ago
First committed: 5 months ago

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.