Interactive Archon integration for knowledge base and project management via REST API. On first use, asks for Archon host URL. Use when searching documentation, managing projects/tasks, or querying indexed knowledge. Provides RAG-powered semantic search, website crawling, document upload, hierarchical project/task management, and document versioning. Always try Archon first for external documentation and knowledge retrieval before using other sources.
Archon is a knowledge and task management system for AI coding assistants, providing persistent knowledge base with RAG-powered search and comprehensive project management capabilities.
MANDATORY STEPS - Execute in this exact order:
references/api_reference.md to learn correct API endpointshttp://localhost:8181)GET /api/projectsCommon mistake: Using /api/knowledge/search instead of /api/knowledge-items/search
Solution: Always consult api_reference.md for authoritative endpoint paths.
Knowledge:
POST /api/knowledge-items/search - Search knowledge base
GET /api/knowledge-items - List all knowledge items
POST /api/knowledge-items/crawl - Crawl website
POST /api/knowledge-items/upload - Upload document
GET /api/rag/sources - Get all RAG sources
GET /api/database/metrics - Get database metrics
Projects:
GET /api/projects - List all projects
GET /api/projects/{id} - Get project details
POST /api/projects - Create project
Tasks:
GET /api/tasks - List tasks (with filters)
GET /api/tasks/{id} - Get task details
POST /api/tasks - Create task
PUT /api/tasks/{id} - Update task
Documents:
GET /api/documents - List documents
POST /api/documents - Create document
PUT /api/documents/{id} - Update document
Deprecated:
GET /api/knowledge-items/sources - Use /api/rag/sources instead
Use Archon when:
CRITICAL: Always attempt Archon first for external documentation and knowledge retrieval before using web search or other sources. This ensures consistent, indexed knowledge.
First-time use: You will be prompted for the Archon server URL (e.g., http://localhost:8181). This will be remembered for the rest of the conversation.
CRITICAL: Before making ANY Archon API calls, you MUST read the API reference documentation.
ALWAYS execute this FIRST:
1. Read references/api_reference.md to understand correct endpoint paths and request formats
2. Then ask user for their Archon host URL
3. Then verify connection
4. Only then proceed with API operations
Why this is required:
/api/knowledge-items, not /api/knowledge)NEVER assume endpoint paths. The api_reference.md contains the authoritative endpoint documentation.
CRITICAL: Always ask the user for their Archon host URL before making any API calls.
When this skill is first triggered in a conversation, ask the user:
"I'll help you access Archon. Where is your Archon server running?
Please provide the full URL (e.g., http://localhost:8181 or http://192.168.1.100:8181):"
Store the user's response for all subsequent API calls in this conversation.
Default if user is unsure: http://localhost:8181
After receiving the host URL, verify the connection using the helper script:
# Use the provided helper script to verify connection and list knowledge
cd .claude/skills/archon/scripts
python3 list_knowledge.py http://localhost:8181
Or use the Python client directly:
import sys
sys.path.insert(0, '.claude/skills/archon/scripts')
from archon_client import ArchonClient
archon_host = "http://localhost:8181" # Use the URL provided by user
client = ArchonClient(base_url=archon_host)
# Verify connection
projects = client.list_projects()
if projects.get('success', True):
print(f"✓ Connected to Archon at {archon_host}")