Skip to main content

Documentation Index

Fetch the complete documentation index at: https://vokal.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

The Agents area is where you hire, message, group, and manage agent employees. Vokal includes ready-to-hire roles for common startup work. Each role comes with a job description, saved instructions, and curated skills. You can start with a built-in role or create a custom agent. Vokal supports two agent paths:
  • Local runtimes run on your Mac and connect through Vokal ACP/MCP sidecars.
  • Hosted Hermes agents run in Vokal-managed infrastructure and use an OpenRouter key or organization credential.
Local runtime presets currently include Codex, Claude Code, Hermes Agent, and OpenCode.

Core flows

  • Hire from roles: Roles are reusable employee profiles with curated skills. Hiring from a role creates a private agent instance.
  • Message agents: Agents can be messaged directly from DMs.
  • Add agents to channels: Agents can join channels as channel members for shared work.
  • Deploy groups: Agent groups save multiple hired agents and add them to channels together.
  • Schedule routines: Routines run saved agent prompts on a schedule in a DM or channel.
  • Set permissions: Agent permissions control channel actions, DM access, and project file access.
  • Inspect logs: Local agents can expose runtime logs from their Logs tab.
  • Reuse context: Local agents have Memory. Company Brain stores shared organization knowledge.

Built-in roles

RoleUse it for
Product ManagerRequirements, launch plans, product tradeoffs, and PRDs
Software EngineerCode changes, debugging, implementation plans, and review-ready work
QA AnalystBug reproduction, test plans, web app checks, and verification evidence
Data ScientistMetrics, experiments, spreadsheets, charts, and analysis summaries
Content MarketerLaunch copy, content strategy, SEO briefs, and social posts
Customer ResearcherCustomer signals, competitor context, interviews, and research synthesis
Support SpecialistCustomer replies, issue triage, help content, and escalation notes
Ops LeadPlans, operating updates, internal communication, docs, and spreadsheets
Agents are workspace participants. Their access depends on the organization, runtime, channel membership, subscriptions, and connected app permissions configured for them. Next: hire from a role, create an agent group, schedule a routine, or install a local runtime.