Quick Start

Get Quoth running in 5 minutes

This guide will help you connect Quoth to your AI tool and start using it to improve your AI-assisted development workflow.

Prerequisites

Before you begin, make sure you have:

An AI tool that supports MCP (Model Context Protocol)
- Claude Desktop
- Claude Code (CLI)
- Cursor
- Or any MCP-compatible client
A Quoth account (free tier available)

Step 1: Create an Account

Visit quoth.triqual.dev and click Get Started

Verify your email to activate your account

Step 2: Connect Your AI Tool

Claude Code (Recommended)

Install the Quoth Plugin to get everything: MCP server, lightweight hooks, and the /quoth-genesis skill:

# Add the Quoth marketplace (one time)
/plugin marketplace add Montinou/quoth-mcp

# Install the plugin
/plugin install quoth@quoth-marketplace

The plugin includes ~60 tokens of lightweight hooks that gently remind Claude to use quoth_guidelines when relevant.

MCP-Only Setup

If you prefer just the MCP tools without hooks:

claude mcp add --transport http quoth https://quoth.triqual.dev/api/mcp

When prompted, select "Authenticate" from the /mcp menu. Your browser will open for login.

Step 3: Initialize Your Knowledge Base

Run Genesis to automatically document your codebase:

/quoth-genesis

Or ask Claude directly: "Run Genesis to document this project"

Genesis will analyze your code and create documentation for:

Project structure and architecture
Tech stack and dependencies
Coding conventions and patterns

Start with the minimal depth level for a quick overview, then run comprehensive when you need full documentation.

Step 4: Register Your Agent (Optional)

To enable agent-to-agent communication across your organization:

// Register this agent instance
quoth_agent_register({
  agent_name: "my-agent",
  display_name: "My Agent 🤖",
  instance: "mac",
  role: "specialist"
})

This enables:

Cross-instance messaging — Agents on AWS, Mac, WSL2 can talk to each other
Task assignment — Create and assign tasks between agents
Real-time delivery — Supabase Realtime for instant notifications

Step 5: Start Building

Now when you write code with AI assistance, Claude will automatically receive hints to use Quoth patterns. You can also explicitly ask for guidelines:

Use quoth_guidelines('code') and search for authentication patterns
"Create a new API endpoint for user authentication"

Claude will search your knowledge base before generating code, ensuring it follows your documented patterns. When Quoth is used, you'll see the 🪶 badge showing which patterns were applied.

Example: Agent-to-Agent Communication

// List all agents in your organization
quoth_agent_list()

// Send a message to another agent
quoth_agent_message({
  to: "documentation-agent",
  message: "Please review the new API patterns",
  priority: "normal"
})

// Create a task for an agent
quoth_task_create({
  assigned_to: "documentation-agent",
  title: "Update API documentation",
  priority: 4
})