Agents

Agents in noetect are configured AI assistants with specific capabilities and personalities.

What are Agents?

An agent is a Claude configuration with:

• A system prompt defining its behavior
• A model selection (Sonnet, Opus, or Haiku)
• MCP servers for external tool access
• Allowed tools for persistent permissions

Default Agent

noetect ships with a default "General Assistant" agent:

• Uses Claude Sonnet 4.5
• No MCP servers enabled
• Works out of the box for general tasks

Creating Custom Agents

Create agents tailored to specific workflows:

Example: Code Review Agent

Name: Code Reviewer
Model: Claude Opus 4
System Prompt: You are a senior software engineer conducting code reviews.
Focus on code quality, potential bugs, performance issues, and best practices.
Be thorough but constructive in your feedback.

Example: Writing Assistant

Name: Writing Helper
Model: Claude Sonnet 4.5
System Prompt: You are a writing assistant helping with documentation,
blog posts, and technical writing. Focus on clarity, grammar, and
making complex topics accessible.

Managing Agents

Creating an Agent

1. Go to Settings → Agents
2. Click New Agent
3. Fill in the configuration:
   • Name and description
   • System prompt
   • Model selection
   • MCP servers (optional)
4. Click Save

Editing Agents

1. Go to Settings → Agents
2. Click on the agent you want to edit
3. Make your changes
4. Click Save

Deleting Agents

1. Go to Settings → Agents
2. Click on the agent
3. Click Delete

Note: The default agent cannot be deleted.

Available Models

Model	Description	Best For
Claude Sonnet 4.5	Fast, capable, cost-effective	General tasks, coding
Claude Opus 4	Most capable, thorough	Complex analysis, research
Claude Haiku 3.5	Fastest, lightweight	Quick questions, simple tasks

MCP Server Integration

Agents can be connected to MCP servers to extend their capabilities:

Available MCP Servers

Server	Description
Linear	Project management, issues, teams

More MCP servers will be added over time.

Enabling MCP Servers

1. Edit your agent configuration
2. Select the MCP servers to enable
3. Save the agent

When you use this agent, it will have access to the tools provided by those MCP servers.

Tool Permissions

When an agent tries to use a tool for the first time, you'll be asked to approve. You can:

• Allow once: Permit this specific use
• Always allow: Add to the agent's allowed tools list

Persistent permissions are saved with the agent configuration.

Switching Agents

Change the active agent from:

• The agent selector in the chat interface
• The command palette (⌘K) — search for agent names

Your last-used agent is remembered and will be selected by default.