prompticorn

A unified, tool-agnostic prompt architecture for managing AI coding-assistant configurations across 17 assistants.

Version: the published version is dynamic. pyproject.toml declares dynamic = ["version"] sourced from prompticorn/__about__.py, and CI/CD injects the real MAJOR.MINOR.PATCH at build time. Local and editable installs report 0.0.0.dev0. Check your installed version with pip 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 plus CLAUDE.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, and applyTo .github/instructions/
  • Roo Code — .roomodes custom modes plus .roo/ rules, skills, and commands
  • JetBrains Junie (CLI) — .junie/ agents, skills, and commands plus AGENTS.md
  • Zed — .agents/skills/ (agents-as-skills) plus AGENTS.md instructions
  • Gemini CLI — .gemini/ agents, skills, and TOML commands plus AGENTS.md
  • Amazon Q (CLI) — .amazonq/ JSON agents, rules/ conventions, and prompts
  • Windsurf / Cascade — .windsurf/ skills, glob-scoped rules/, and workflows
  • Continue.dev — .continue/ glob-scoped rules/ and invokable prompts/
  • Aider — CONVENTIONS.md plus .aider.conf.yml (conventions only)
  • OpenAI Codex (CLI) — AGENTS.md plus .agents/skills/ and .codex/config.toml

What's in the library

  • 25 primary agents (architect, backend, frontend, code, test, debug, security, devops, and more)
  • ~100 workflows in minimal and verbose variants
  • ~95 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; flat is the default and src is 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

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

Project links

Data verified by PyPI on Aug 22, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.52.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for dassnoodleboot from gravatar.com dassnoodleboot

Credits

Author: john@snoodleboot.io

GitHub Statistics

Data verified by PyPI on Aug 22, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (MIT)

Requires

Python >=3.10

Tags

ai cli coding-assistant configuration prompts

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

prompticorn-1.50.0.tar.gz (6.7 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

prompticorn-1.50.0-py3-none-any.whl (2.2 MB view details)

Uploaded Python 3

File details

Details for the file prompticorn-1.50.0.tar.gz.

File metadata

  • Download URL: prompticorn-1.50.0.tar.gz
  • Upload date:
  • Size: 6.7 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for prompticorn-1.50.0.tar.gz
Algorithm Hash digest
SHA256 4ecdb10b53477869a1589f138e1f358d1cfbcc6ed9a042d751d5242475a4c860
MD5 47e818fecf8983337a826fdecc888be4
BLAKE2b-256 08c29774de2e8af330eb4a282bd6da052490c2ab7319093ff96e3647e07a4636

See more details on using hashes here.

Provenance

The following attestation bundles were made for prompticorn-1.50.0.tar.gz:

Publisher: ci-cd.yml on snoodleboot-io/prompticorn

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file prompticorn-1.50.0-py3-none-any.whl.

File metadata

  • Download URL: prompticorn-1.50.0-py3-none-any.whl
  • Upload date:
  • Size: 2.2 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for prompticorn-1.50.0-py3-none-any.whl
Algorithm Hash digest
SHA256 707e848dbd5fdfdc16c867f8ef0b85f5b27066d285be74fd5d4c2c85323b45b1
MD5 ed53005497c5c7ab15545d74349b0743
BLAKE2b-256 00ea0074be36d65a16b383622a0accdddcfff70db30e68476f28231e12a8b247

See more details on using hashes here.

Provenance

The following attestation bundles were made for prompticorn-1.50.0-py3-none-any.whl:

Publisher: ci-cd.yml on snoodleboot-io/prompticorn

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

1.52.0

2 files

1.51.0

2 files

This release

1.50.0 This release

2 files

1.49.0

2 files

1.48.0

2 files

1.47.0

2 files

1.46.0

2 files

1.45.0

2 files

1.44.0

2 files

1.43.0

2 files

1.42.0

2 files

1.41.0

2 files

1.40.0

2 files

1.39.0

2 files

1.38.0

2 files

1.37.0

2 files

1.36.0

2 files

1.35.0

2 files

1.34.0

2 files

1.33.0

2 files

1.32.0

2 files

1.31.0

2 files

1.30.0

2 files

1.29.0

2 files

1.28.0

2 files

1.27.0

2 files

1.26.0

2 files

1.25.0

2 files

1.24.0

2 files

1.23.0

2 files

1.22.0

2 files

1.21.0

2 files

1.20.0

2 files

1.19.0

2 files

1.18.0

2 files

1.17.0

2 files

1.16.0

2 files

1.15.0

2 files

1.14.0

2 files

1.13.0

2 files

1.12.0

2 files

1.11.0

2 files

1.10.0

2 files

1.9.0

2 files

1.8.0

2 files

1.7.0

2 files

1.6.0

2 files

1.5.0

2 files

1.4.0

2 files

1.3.0

2 files

1.2.0

2 files

1.1.0

2 files

0.1.0

2 files

0.0.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page