AI SummaryIntentKit is an open-source, self-hosted cloud agent cluster that manages a collaborative team of AI agents for you.
Install
Copy this and paste it into Claude Code, Cursor, or any AI assistant:
I want to add the "intentkit — Copilot Instructions" prompt rules to my project. Repository: https://github.com/crestalnetwork/intentkit Please read the repo to find the rules/prompt file, then: 1. Download it to the correct location (.cursorrules, .windsurfrules, .github/prompts/, or project root — based on the file type) 2. If there's an existing rules file, merge the new rules in rather than overwriting 3. Confirm what was added
Description
IntentKit is an open-source, self-hosted cloud agent cluster that manages a collaborative team of AI agents for you.
Architecture
• intentkit/ — pip package • core/ — agent system (LangGraph) • manager/ — single agent manager • system_skills/ — built-in system skills • models/ — Pydantic + SQLAlchemy dual models • config/ — system config (DB, LLM keys, skill provider keys) • skills/ — skill system (LangChain BaseTool) • abstracts/ — interfaces for core/ and skills/ • utils/ — utilities • clients/ — external service clients • app/ — API server, autonomous runner, background scheduler • frontend/ — Next.js agent management UI (see frontend/AGENTS.md) • integrations/ — Go channel adapters (see integrations/AGENTS.md) • telegram/ — Telegram bot (see integrations/telegram/AGENTS.md) • wechat/ — WeChat bot (see integrations/wechat/AGENTS.md) • scripts/ — ops & migration scripts • tests/ — tests/core/, tests/api/, tests/skills/
Tech Stack & Gotchas
• Package manager: uv. Activate venv: source .venv/bin/activate • Lint: ruff format & ruff check --fix after edits • Type check: BasedPyright — ensure no errors in changed files • SQLAlchemy 2.0 — do NOT use legacy 1.x API • Pydantic V2 — do NOT use V1 API • Testing: pytest
Rules
• English for code comments and search queries • Do not git commit unless explicitly asked • After adding a new feature, add the corresponding tests. • After modifying an existing feature, check whether any corresponding tests need to be updated, and make sure all tests pass. • Import dependency order (left cannot import right): utils → config → models → abstracts → clients → skills → core • No ForeignKey constraints: All tables intentionally omit ForeignKey constraints. Do NOT add FK constraints to any table definition. • AgentCore ↔ Template sync: AgentCore (Pydantic) is the shared base for both Agent and Template. When adding/removing fields in AgentCore, you MUST also update TemplateTable (SQLAlchemy columns in intentkit/models/template.py) to match. The Template Pydantic model inherits from AgentCore automatically, but the DB schema does not. Agent-specific fields like slug belong in AgentUserInput, not AgentCore.
Detailed Guides
• Skills: agent_docs/skill_development.md • Git/PR/Release: agent_docs/ops_guide.md • Testing: agent_docs/test.md
Discussion
Health Signals
My Fox Den
Community Rating
Sign in to rate this booster
Works With
Any AI assistant that accepts custom rules or system prompts