space-edit

What problem does it solve?

Editing Anteroom space definitions (repos, packs, instructions, and config) is error-prone and can leave running sessions or shared repositories in an inconsistent state; this Skill provides a guided, validated workflow to make changes safely and transparently.

Core Features & Use Cases

• Inspect current state: Display current repos, local path mappings, packs, instructions preview, and config overrides before any change.
• Manage repositories and mappings: Add or remove repos, validate URL schemes, check duplicates, and map local directories without altering .local.yaml directly.
• Manage packs and instructions: Add/remove packs using namespace/name validation and replace or trim long instructions with warnings.
• Safe updates and validation: Preserve comments where possible, run Python-based validation, refresh the running session, revert on validation failure, and optionally commit changes if the space file sits in a git repo.
• Use case: A developer adds a new repository to a team's shared space, maps a local checkout, validates the YAML, refreshes the space, and commits the change to the repo.

Quick Start

Use the CLI to run aroom space edit with the space name and describe the change you want to apply, for example adding a repo or updating instructions.