agentstack ui

Synopsis

agentstack ui edit [--profile-file <path>] [--port <number>]

Description

The ui command launches a local web editor for your canonical agentstack.yaml profile. The editor runs on loopback only (127.0.0.1) and uses an ephemeral token for security. Changes are saved directly to the profile file.

Subcommands

edit

Open the web editor for a profile.

Flag	Type	Default	Description
--profile-file <path>	string	Active profile	Path to the agentstack.yaml to edit
--port <number>	number	3847	Local port to listen on

Examples

Open the editor for the active profile:

Open web editor

agentstack ui edit

Edit a specific profile file:

Edit specific profile

agentstack ui edit \
  --profile-file ~/.agentstack/profiles/work/agentstack.yaml

Use a custom port:

Custom port

agentstack ui edit --port 4000

Notes

Note

The web editor is loopback-only (127.0.0.1). It is not accessible from other machines on the network. An ephemeral token is generated on each launch for security.

Tip

The web editor is useful for visually managing MCP servers and skills without manually editing YAML. Changes are saved in real time to the profile file.