Metadata-Version: 2.4
Name: agentic-toolbelt
Version: 0.1.17
Summary: Packages agent payload assets and installs them into a project via the agentic-set CLI.
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Provides-Extra: test
Requires-Dist: pytest>=8; extra == "test"
Requires-Dist: tomli>=1.1.0; python_version < "3.11" and extra == "test"
Dynamic: requires-python

# Agentic Toolbelt

**Author:** Roberto Del Prete

## Purpose

`agentic-toolbelt` packages reproducible agent-operating defaults and installs them into any project with a CLI.
`pip install` only installs the Python package and its bundled resources into the environment.
To copy `.agents`, `.codex`, `templates`, and `AGENTS.md` into a target project, run `agentic-set` in that project directory.

The installer payload includes:

- `.agents`
- `.codex`
- `.github`
- `templates`
- `AGENTS.md`

The repository exists to standardize how autonomous agents are configured, launched, and governed across different codebases.

## Features

- CLI entrypoints:
  - `agentic-set`: installs the packaged `AGENTS.md` prompt
- Copies packaged payload directly into the directory where the command is launched
- Creates an active Codex runtime by materializing `.codex/config.toml` and `.codex/agents/*.toml` from packaged templates
- Supports `--force` to overwrite existing `.agents`, `.codex`, `.github`, `templates`, and `AGENTS.md`
- Safe copy flow with temporary staging and cleanup

## Installation

`agentic-toolbelt` supports Python 3.9 and newer on any platform with a supported Python interpreter.

From the repository root:

```bash
python -m pip install .
```

Then bootstrap the current project:

```bash
agentic-set
```

For local development and test runs:

```bash
python -m pip install -e ".[test]"
```

This registers the `agentic-set` console script in that environment. It does not copy payload files into your repository until you run the command.

## Usage

From any project directory, install the default baseline:

```bash
agentic-set
```

This copies the packaged payload and creates the active Codex runtime files:

- `.codex/config.toml`
- `.codex/agents/*.toml`

Those runtime files are generated from the packaged templates so the installed repo can resolve named agents such as `planner` and `implementer` immediately after bootstrap.

Force overwrite when files already exist:

```bash
agentic-set --force
```

Without `--force`, existing destination paths are preserved.

## Docs Site

A graphical overview page is available at:

- `docs/index.html`

Open it in a browser to view the repo concept, architecture, and CLI workflows.

## Development

- Python package entrypoint is also declared in `setup.py` and `pyproject.toml`.
- Current package version is maintained in both `pyproject.toml` and `setup.py`.

## Release Checks

Build and verify the distributable artifacts from the repository root:

```bash
python -m pytest
python -m build
python -m twine check dist/*
```

If you want a smoke test of the built wheel, install it into a clean virtual environment and run:

```bash
agentic-set --help
```
