Skip to main content

​
Directory Commands

Agent directory management — register, remove, list, and edit agent entries.

​
genie dir add

Register an agent in the directory. 
genie dir add <name> --dir <path> [options]
Terminal
$ genie dir add sofia --dir ~/agents/sofia --model opus --roles engineer,reviewer
Agent "sofia" registered (project).
  Dir: ~/agents/sofia
  Prompt mode: append
  Model: opus
  Roles: engineer, reviewer

​
Options

FlagDescriptionDefault
--dir <path>Agent folder (CWD + AGENTS.md)Required
--repo <path>Default git repo—
--prompt-mode <mode>Prompt mode: append or systemappend
--model <model>Default model (sonnet, opus, codex)—
--roles <roles...>Built-in roles this agent can orchestrate—
--globalWrite to global directory instead of project—

​
genie dir rm

Remove an agent from the directory. 
genie dir rm <name> [--global]
Terminal
$ genie dir rm sofia
Agent "sofia" removed from project directory.

​
genie dir ls

List all registered agents or show details for a specific agent. 
genie dir ls [<name>]
Terminal
$ genie dir ls
AGENT     DIR                    MODEL    ROLES              SCOPE
sofia     ~/agents/sofia         opus     engineer,reviewer  project
marco     ~/agents/marco         sonnet   engineer           global

$ genie dir ls sofia
Agent: sofia
  Dir:         ~/agents/sofia
  Repo:        ~/projects/myapp
  Prompt mode: append
  Model:       opus
  Roles:       engineer, reviewer
  Scope:       project

​
genie dir edit

Update fields on an existing agent entry. 
genie dir edit <name> [options]
Terminal
$ genie dir edit sofia --model sonnet --roles engineer
Agent "sofia" updated.
  Model: opus → sonnet
  Roles: engineer,reviewer → engineer

​
genie agent register

Register an agent locally and auto-register in Omni (if configured). 
genie agent register <name>
Terminal
$ genie agent register sofia
Agent "sofia" registered locally.
  Omni registration: ✅ connected to omni-api
  Provider: automagik-genie

​
genie init agent

Scaffold a new agent in the workspace. Creates the agent directory structure with default configuration files. 
genie init agent <name>

$ genie init agent sofia
Created agent scaffold at .genie/agents/sofia/
  SOUL.md        — agent personality and instructions
  HEARTBEAT.md   — recurring task checklist

​
Scope

Agent entries can be stored at two levels:
ScopeLocationUse case
Project.genie/directory.jsonAgents specific to this repo
Global~/.genie/directory.jsonAgents available across all repos
Use --global to target the global directory.