Skip to content
Cheffed

Agents

Agents are the core of Cheffed. They define how AI models interact with your code and what tasks they can perform.

What is an Agent?

Section titled “What is an Agent?”

An agent is a combination of:

  • A prompt template that defines the agent’s behavior, expertise, and approach
  • Tool access that allows the agent to read files, write code, run commands, and more
  • An AI model that powers the agent’s reasoning and responses

When you start a session, you’re essentially deploying an agent into an isolated environment where it can work on your behalf.

Cheffed’s agent capabilities are powered by OpenCode, an open-source AI coding agent that provides the underlying harness for tool execution, code intelligence, and session management.

Sessions

Section titled “Sessions”

A session is a running instance of an agent. Each session:

  • Runs in an isolated container environment
  • Has full filesystem and shell access within its container
  • Maintains conversation history and context
  • Can interact with connected repositories and services

Sessions are ephemeral by default but preserve their conversation history for review.

Prompt Templates

Section titled “Prompt Templates”

Prompt templates define an agent’s personality and expertise. Cheffed provides built-in templates for common tasks:

TemplateDescription
Code ReviewAnalyzes code for bugs, security issues, and improvements
Bug FixInvestigates and fixes reported issues
Feature ImplementationBuilds new features based on requirements
RefactoringImproves code structure without changing behavior
DocumentationGenerates or updates documentation

You can also create custom prompt templates for your specific workflows.

Agent Capabilities

Section titled “Agent Capabilities”

Agents in Cheffed have access to powerful tools:

File Operations

Section titled “File Operations”
  • Read - View file contents
  • Write - Create or overwrite files
  • Edit - Make targeted changes to existing files
  • Glob - Find files by pattern

Shell Access

Section titled “Shell Access”
  • Bash - Execute shell commands
  • Full access to installed CLI tools (git, npm, etc.)

Code Intelligence

Section titled “Code Intelligence”
  • Search codebases
  • Understand project structure
  • Navigate dependencies

External Integrations

Section titled “External Integrations”
  • Create GitHub pull requests
  • Interact with APIs
  • Deploy to cloud providers (if configured)

Tags and Discovery

Section titled “Tags and Discovery”

Agents are organized with tags to help you find the right one:

  • frontend - React, Vue, CSS, UI/UX tasks
  • backend - APIs, databases, server-side logic
  • devops - CI/CD, infrastructure, deployments
  • testing - Unit tests, integration tests, E2E
  • documentation - READMEs, API docs, guides

Browse agents by tag on the Agents page, or search for specific capabilities.

Next Steps

Section titled “Next Steps”