agentry-cli 0.1.0

A CLI tool to easily reuse AI agent instructions, skills, philosophies or other prompt files.

Agentry

A CLI tool to easily reuse AI agent instructions, skills, philosophies or other prompt files.

Installation

Python 3.13+ is required.

pip install agentry

Or with uv:

uv tool install agentry

Quick Start

agentry install https://gitlab.com/owner/repo/-/tree/main/commands "**/*.md" \
  --integration claude --scope user

Run without arguments to answer prompts interactively:

agentry install

Usage

Run agentry --help to see all available options.

Argument / Option	Short	Description
REPO		Source URL or local path
PATTERN		Glob pattern for files to install, e.g. **/*.md
--integration	-i	Target integration — currently claude
--scope	-s	user or project
--token	-t	Auth token for private repositories (or AGENTRY_TOKEN env var)

Scopes

Scope	Effect
user	Prompts available across all projects
project	Prompts scoped to the current project

Remote URL format

GitLab tree URLs are currently supported:

https://gitlab.com/{owner}/{repo}/-/tree/{branch}[/{subpath}]

Point to a branch root or a subdirectory. Only files matching PATTERN within that tree are installed.

# Entire repo, main branch
agentry install https://gitlab.com/org/prompts/-/tree/main "**/*.md" --scope user

# Subdirectory on a different branch
agentry install https://gitlab.com/org/prompts/-/tree/develop/commands "*.md" --scope project

Private repositories

# Pass inline
agentry install https://gitlab.com/org/private-prompts/-/tree/main "**/*.md" --token glpat-xxxx

# Or via environment variable
export AGENTRY_TOKEN=glpat-xxxx
agentry install https://gitlab.com/org/private-prompts/-/tree/main "**/*.md"

Local paths

agentry install ./my-prompts "*.md" --integration claude --scope project

Development

Prerequisites

• Python >= 3.13
• uv (recommended)
• just (optional)

Getting Started

git clone https://gitlab.com/agent-wisdom/agentry.git
cd agentry
uv sync
uv run pre-commit install

Running Checks

just check
# or
uv run ruff check --fix && uv run ruff format && uv run pyright && uv run pytest

License

MIT — see LICENSE.