Documentation
¶
Overview ¶
Package agentfs discovers and reads agent metadata from the filesystem.
Agents are represented as flat .md files under a team path (e.g., yuki.md) with YAML frontmatter fields (name, role, voice, emoji, etc.). Provides functions to discover all agents, look up a single agent by name or path, filter by role, and update individual frontmatter fields in place.
Plane: shared
Index ¶
Constants ¶
This section is empty.
Variables ¶
SkipFiles contains known non-agent files to exclude from discovery.
Functions ¶
func DiscoverAgents ¶
DiscoverAgents returns sorted agent names from flat .md files in team root.
Types ¶
type AgentInfo ¶
type AgentInfo struct {
Name string // directory name (lowercase)
Path string // absolute path to agent directory
Voice string // Kokoro TTS voice ID
Emoji string // display emoji
Description string // short role summary
Role string // e.g. designer, researcher — matches [prompts] key
}
AgentInfo holds agent metadata parsed from .md file frontmatter.
func Discover ¶
Discover scans teamPath for agents via flat .md files (e.g., yuki.md). Returns sorted list of agents with metadata parsed from frontmatter.
func FindByRole ¶
FindByRole returns all agents with a matching role field.
func GetFromPath ¶
GetFromPath returns agent metadata from an absolute agent directory path.