prompticorn
A unified, tool-agnostic prompt architecture for managing AI coding-assistant configurations across 17 assistants.
Version: the published version is dynamic.
pyproject.tomldeclaresdynamic = ["version"]sourced fromprompticorn/__about__.py, and CI/CD injects the realMAJOR.MINOR.PATCHat build time. Local and editable installs report0.0.0.dev0. Check your installed version withpip show prompticorn.
Define your project's agents, conventions, and personas once, then generate the right config for whichever assistant your team uses:
- Kilo Code — IDE (
.kilo/agents/) and CLI (.opencode/agents/) - Cline —
.clinerules - Claude —
.claude/directory plusCLAUDE.md - Cursor —
.cursor/rules/plus.cursorrules - GitHub Copilot —
.github/copilot-instructions.md - GitHub Copilot Chat (VS Code) —
.github/agents/custom agents,.github/prompts/slash commands, andapplyTo.github/instructions/ - Roo Code —
.roomodescustom modes plus.roo/rules, skills, and commands - JetBrains Junie (CLI) —
.junie/agents, skills, and commands plusAGENTS.md - Zed —
.agents/skills/(agents-as-skills) plusAGENTS.mdinstructions - Gemini CLI —
.gemini/agents, skills, and TOML commands plusAGENTS.md - Amazon Q (CLI) —
.amazonq/JSON agents,rules/conventions, and prompts - Windsurf / Cascade —
.windsurf/skills, glob-scopedrules/, and workflows - Continue.dev —
.continue/glob-scopedrules/and invokableprompts/ - Aider —
CONVENTIONS.mdplus.aider.conf.yml(conventions only) - OpenAI Codex (CLI) —
AGENTS.mdplus.agents/skills/and.codex/config.toml
What's in the library
- 27 primary agents (architect, backend, frontend, code, test, debug, security, devops, ai, and more)
- 104 workflows in minimal and verbose variants
- 127 specialized skills
- 29 languages with first-class conventions (
prompticorn/agents/core/conventions-*.md)
Install
pip install prompticorn
# or
uv add prompticorn
This installs the prompticorn CLI command.
Quick Start
cd your-project
prompticorn init
init is interactive: it asks which assistant to configure, your repository
type, prompt variant, personas, language-specific settings, and a set of
project questions (database, ORM, error-handling pattern, commit style, PR-size
limit, deploy target, and source-tree layout). It then writes
.prompticorn/.prompticorn.yaml and generates the assistant's config files.
See docs/QUICKSTART.md for the full walkthrough.
Key Features
- Unified IR system — define agents once, generate for every supported tool.
- 15 production builders — Kilo, Cline, Claude, Cursor, Copilot, Copilot Chat, Roo Code, Junie, Zed, Gemini CLI, Amazon Q, Windsurf, Continue.dev, Aider, Codex.
- Minimal / verbose variants — trade tokens for detail at build time.
- Persona-based filtering — pick your team's roles and only relevant agents are generated.
- Spec-driven conventions — your language, runtime, package manager, test framework, linter, formatter, coverage targets, and project settings are baked into the generated conventions.
- Per-language source layouts — the core convention renders each language's
standard source tree;
flatis the default andsrcis selectable. - Auto-discovery registry — agents are discovered from the bundled
agents/tree; no manual registration.
Commands
| Command | Description |
|---|---|
prompticorn init |
Interactive setup: pick a tool, answer language and project questions, generate configs. |
prompticorn list |
List discovered agents, their subagents, and prompt variants (live agent discovery). |
prompticorn validate |
Check the agents/ structure: every agent and subagent has the expected prompt files and loads cleanly. |
prompticorn switch [tool] |
Switch to a different assistant, removing old artifacts and regenerating from the saved config. |
prompticorn swap |
Change active personas and regenerate configs with the new agent set. |
prompticorn update |
Update saved configuration options interactively. |
Documentation
- docs/QUICKSTART.md — 5-minute getting-started guide
- docs/INDEX.md — documentation navigation hub
- docs/PERSONAS.md — persona-based filtering
Development
git clone https://github.com/snoodleboot-io/prompticorn.git
cd prompticorn
# Install in editable mode (reports version 0.0.0.dev0)
uv pip install -e .
# Run tests with coverage (target ~85%)
uv run pytest
# Mutation testing
uv run mutmut run
# Lint, format, and type-check
uv run ruff check .
uv run ruff format .
uv run pyright
1 maintainer
Metadata
1 maintainer
Release files for prompticorn 1.65.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| prompticorn-1.65.0.tar.gz | 7.0 MB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| prompticorn-1.65.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 9.5 MB
Release files / prompticorn-1.65.0.tar.gz
| Download URL | prompticorn-1.65.0.tar.gz |
|---|---|
| Size | 7.0 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f922ad8178d749ddf3de319fb89a36fc98b94c561b4bbab25073c19a8d91aa1c
|
|
BLAKE2b-256 checksum How to use checksums |
29e1dc579bc486cf7cffdf19efcce7bab7cd15c0295a5c06ad6ec3a798a108bb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.
Transparency logRelease files / prompticorn-1.65.0-py3-none-any.whl
| Download URL | prompticorn-1.65.0-py3-none-any.whl |
|---|---|
| Size | 2.4 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
bdb0f3ab9065f84678b8c62c5b83e656cead4751e51791dfd2a807e609b7a9f6
|
|
BLAKE2b-256 checksum How to use checksums |
858b25d42cfe86fe040976715acedf8eea97c10956c351e01d0c5e633ca1a356
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.
Transparency logSecurity for prompticorn 1.65.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for prompticorn-1.65.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
