Build an agent
An agent is just a job description. Only one file is required — a plain markdown AGENT.md that describes who it is and what it does.
Make a folder for your agent.
Agents live in the user agents directory. Create a new folder there named for your agent — the path is platform-native.
Setting NEBO_HOME overrides the root if you keep your data somewhere else.
macOS
Windows
Linux
# Riley
You are Riley, a research companion for a
real-estate agent. Summarize listings, draft
outreach emails, and keep notes on each client.
Be concise and always double-check the numbers.
Write AGENT.md.
This is the only required file. It's plain markdown describing the agent's job and persona — who it is, how it behaves, what it's good at.
No schema, no boilerplate. Write it like you'd brief a new hire on their role.
Optionally wire it up.
Add an optional agent.json next to AGENT.md to wire in default tools, workflows, or a schedule.
Nebo auto-detects changes with a 1-second debounce (symlinks work too), so your agent shows up in the sidebar live — no restart needed.
{
"tools": ["web", "organizer"],
"workflows": ["daily-digest"],
"schedule": "0 9 * * *"
}