prompt-manager-cli
A CLI tool to create and organize prompt files for code agents (Claude Code, Codex, Gemini CLI, etc.).
Installation
# using uv
uv tool install prompt-manager-cli
# using pip
pipx install prompt-manager-cli
Or install in editable mode for development:
pip install -e ".[dev]"
Usage
Initialize a project
pm init
This creates .pm/template.md with the default template. Edit this file to customize your prompts.
Create a new prompt file
pm new
This creates a new Markdown file in .pm/prompts/ and opens it in your editor.
prompt-2026-01-05-14-37-a1b2c3d.md
You can specify the editor directly:
pm new micro
pm new code
pm new vim
Options
# Specify a custom output directory
pm new --dir ./my-prompts
# Combine editor and directory
pm new micro --dir ./my-prompts
Editor Configuration
The editor is resolved in this order:
- Command argument:
pm new micro - Local config:
.pm/editor(per-repo) - Environment:
$PM_EDITOR(global)
To set your default editor, add to your shell profile (.bashrc, .zshrc, etc.):
export PM_EDITOR="micro"
To override per-project:
echo "code" > .pm/editor
Custom Templates
Run pm init to create .pm/template.md with the default template, then edit it to customize your prompts.
You can also create a global template at ~/.pm/template.md for use across all projects. Local templates take precedence over global templates.
Template Variables
Templates use Python's string formatting. Available variables:
| Variable | Description | Example |
|---|---|---|
{created_at} |
ISO 8601 timestamp with timezone | 2026-01-05T14:37:00+01:00 |
{git_hash} |
Short git hash or "nogit" | a1b2c3d |
{cwd} |
Absolute path to current directory | /home/user/project |
Example Custom Template
---
date: "{created_at}"
commit: "{git_hash}"
project: "{cwd}"
---
## What I Want
## Background
## Requirements
## Done When
Local Development
Run directly without installing:
python -m prompt_manager_cli new
Run tests:
pytest
License
MIT
Metadata
Release files for prompt-manager-cli 0.1.3
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 | Actions |
|---|---|---|---|---|
| prompt_manager_cli-0.1.3.tar.gz | 8.9 kB | Without provenance | Details for prompt_manager_cli-0.1.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| prompt_manager_cli-0.1.3-py3-none-any.whl | Python 3 | none | any | Details for prompt_manager_cli-0.1.3-py3-none-any.whl |
Total release size: 15.8 kB
Release files / prompt_manager_cli-0.1.3.tar.gz
| Download URL | prompt_manager_cli-0.1.3.tar.gz |
|---|---|
| Size | 8.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e4e6421cfe4c5431fc94c37d1345b7aa75563b827f9477d9b25df5a5b1ab530a
|
|
BLAKE2b-256 checksum How to use checksums |
8c3c36e3ab0e8ce5a3d01f8aa1af802154d66525fbb39b3cbbc6cb65b49f94a8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.18 {"installer":{"name":"uv","version":"0.9.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / prompt_manager_cli-0.1.3-py3-none-any.whl
| Download URL | prompt_manager_cli-0.1.3-py3-none-any.whl |
|---|---|
| Size | 6.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f3dbeb4d1707cb15e694aa735afa6ce4fc6c1d030f7e206be76067561dee26cb
|
|
BLAKE2b-256 checksum How to use checksums |
9da083127805f2a9fa38f4cd6b1832367dba9fcaa3982405915a16d595531cb1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.18 {"installer":{"name":"uv","version":"0.9.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for prompt-manager-cli 0.1.3
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.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A 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.