major agent manages agents as local folders. An agent folder holds two files, agent.jsonc and prompt.md, plus a .major/config.json that links the folder to the agent. Once you have a folder, edit the files and use major validate, major push, and major publish to save and release changes.
Every major agent subcommand accepts --json to print one JSON result.
Commands that take --id default to the agent of the folder you run them in. Outside an agent folder, pass --id.
major agent list
List the agents in your organization, with their IDs and whether each is published or a draft.major agent create
Create a new agent and set up a local folder for it. The directory must not exist yet.major agent clone
Download an existing agent’s latest saved version into a new local folder. Without--id, you pick from the agents you can edit.
major agent info
Show an agent’s published state and latest saved version. Inside the agent’s folder, it also shows your local version and whether it is behind the latest.major agent run
Start a run of the agent’s published version. The command prints the run ID.major agent run list
List the agent’s runs, newest first.major agent run content
Read a run’s messages.major agent run send
Send a message to a run, resuming it if it finished.major agent run stop
Stop a run.major agent slack
Manage the agent’s own Slack app. Allmajor agent slack subcommands take --id, which defaults to the agent folder’s.
major agent slack connect
Provision the agent’s Slack app and print its install URL.major agent slack pause
Silence the agent’s Slack app.major agent slack resume
Re-enable a paused Slack app.major agent slack delete
Permanently delete the agent’s Slack app. You are asked to confirm unless you pass--yes.