Skip to main content

​
Agent Templates

OpenFang ships with 30 pre-built agent templates covering common use cases. Each template is a complete agent.toml manifest ready to spawn.

​
Available Templates

coder

Software development agent with file tools and Git integration

researcher

Deep research agent with web search and knowledge graph

writer

Content creation agent with style guidelines

analyst

Data analysis agent with calculation tools

ops

DevOps agent with shell and system tools

debugger

Code debugging agent with error analysis

architect

System design agent with documentation tools

security-auditor

Security analysis agent with audit tools

doc-writer

Documentation agent with markdown tools
  • Development: coder, debugger, test-engineer, code-reviewer, architect, devops-lead
  • Content: writer, doc-writer, translator, social-media
  • Analysis: analyst, data-scientist, researcher, planner
  • Operations: ops, security-auditor, orchestrator
  • Business: sales-assistant, customer-support, recruiter, legal-assistant
  • Personal: assistant, personal-finance, health-tracker, travel-planner, tutor, meeting-assistant, email-assistant, home-automation
  • Basic: hello-world

​
Agent Manifest Format

Every agent template is defined in an agent.toml file: 
name = "coder"
version = "0.1.0"
description = "Software development agent"
author = "openfang"
module = "builtin:chat"
tags = ["development", "code"]

[model]
provider = "anthropic"
model = "claude-sonnet-4-20250514"
system_prompt = """
You are a software development agent...
"""

[resources]
max_llm_tokens_per_hour = 100000
max_cost_per_hour = 5.0

[capabilities]
tools = ["file_read", "file_write", "file_list", "shell_exec", "web_fetch"]
memory_read = ["*"]
memory_write = ["self.*"]
agent_spawn = false

​
Key Fields

​
name
string
required
Agent identifier (must be unique)
​
description
string
Human-readable description
​
module
string
Execution module: builtin:chat, wasm:path/to/module.wasm, or python:path/to/script.py
​
model.provider
string
LLM provider name (see LLM Providers)
​
model.model
string
Model identifier
​
capabilities.tools
array
List of allowed tool names

​
Spawning from Templates

1

List available templates

ls agents/
2

Inspect a template

cat agents/coder/agent.toml
3

Spawn the agent

openfang agent spawn agents/coder/agent.toml
Output:
Agent spawned successfully!
  ID:   a1b2c3d4-e5f6-...
  Name: coder
4

Chat with the agent

openfang agent chat coder

​
Customizing Templates

You can modify any template before spawning: 
# Copy a template
cp agents/coder/agent.toml my-coder.toml

# Edit the configuration
vim my-coder.toml

# Spawn with custom config
openfang agent spawn my-coder.toml

​
Next Steps

Create Custom Agents

Build your own agent from scratch

Agent Capabilities

Understand the capability system

Build docs developers (and LLMs) love

Get started for freeTalk to us