Agent Management

Every agent has a name, a character, and clear boundaries.
Configure personalities, knowledge bases, and permissions from one settings panel.

Pinchy agent management — configure name, tagline, and model

One Settings Panel, Five Tabs

Every agent is configured through a single settings page. No config files, no CLI, no YAML. Click the gear icon and everything is right there.

General

Name, tagline, avatar, and AI model. Pick from any configured provider — Anthropic, OpenAI, Google, or Ollama. The model dropdown groups by provider so you always know what you're choosing.

Personality

Choose a preset or write a custom SOUL.md. The personality defines how the agent speaks, what tone it uses, and what character it has. Smithers is dry and competent. Your HR agent can be warm and encouraging. Your DevOps agent can be terse and precise.

Instructions

AGENTS.md defines the agent's operating instructions — what it should do, how it should approach tasks, what resources it has. Think of it as the job description.

Permissions

Allow-list of tools the agent can use and directories it can access. Nothing is enabled by default. You grant exactly what's needed, nothing more. Learn more →

Access ★ Enterprise

Who can talk to this agent? Set visibility to "All Users" or "Restricted" and pick the allowed groups. Maps agent access to your org structure. Learn more →

Team-level context (personal preferences, org structure, company conventions) lives in a separate Settings → Context page, not per agent.

Pinchy agent personality configuration with SOUL.md editor

Agents Are Personalities, Not Chatbots

Generic chatbots feel like tools. Named agents with consistent characters feel like colleagues. That's intentional.

Pinchy's default agent — Smithers — is competent, polite, and occasionally dry. He greets new users with an onboarding interview to understand the company and set up the platform.

But Smithers is just the starting point. Every agent you create gets its own personality:

🎯

Professional Assistant

Clear, efficient, focused. Gets to the point. Perfect for executive-facing agents that summarize data and draft communications.

🧑‍💻

Technical Expert

Precise, detailed, opinionated about best practices. Ideal for code review agents, DevOps helpers, and architecture advisors.

🌱

Friendly Helper

Warm, patient, encouraging. Great for onboarding agents, HR assistants, and any agent that works with non-technical teams.

✏️

Custom

Write your own SOUL.md from scratch. Define tone, vocabulary, boundaries, quirks — whatever makes the agent feel right for your team.

Knowledge Bases

An agent without context is just a general-purpose chatbot. An agent with your company's documentation becomes genuinely useful.

Pinchy lets you mount specific directories into an agent's scope. The agent can read files in those directories — and nothing else. No accidental access to HR data from the engineering agent.

📁 Directory Scoping

Select exactly which folders under /data/ the agent can access. A visual directory picker — no path guessing.

🔒 Read-Only by Default

Agents read your documents but can't modify them. If you need write access, you enable it explicitly per tool.

📋 Any Format

Markdown, PDF, plain text, code files — agents read whatever you give them. Mount your wiki, your runbooks, your policies.

v0.4.0 ships with six ready-to-use Knowledge Base templates so you don't start from a blank page:

📄 Knowledge Base
⚖️ Contract Analyzer
👥 Resume Screener
🔀 Proposal Comparator
Compliance Checker
🎓 Onboarding Guide

See the Knowledge Base feature in detail →

Shared and Personal Agents

Shared Agents

Created by admins. Visible to the whole team (or specific groups). Memory and conversations are shared — when one person teaches the agent something, everyone benefits.

Use for: Company knowledge bases, team assistants, department-specific tools.

Personal Agents

Auto-created for each user. Private memory, private conversations. Your personal AI assistant that knows your context without sharing it with others.

Use for: Personal productivity, drafting, brainstorming, individual workflows.

See Agent Management in Action

30-minute demo. We'll walk through creating an agent, configuring its personality, and connecting it to your team's knowledge.

Book a Demo