Metadata-Version: 2.5
Name: agent-repo-kit
Version: 0.2.0
Summary: Scaffold launch-ready, AI-agent-friendly open-source repositories.
Project-URL: Homepage, https://github.com/Uky0Yang/agent-repo-kit
Project-URL: Issues, https://github.com/Uky0Yang/agent-repo-kit/issues
Author: Ukyo
License-Expression: MIT
License-File: LICENSE
Keywords: ai-agents,claude-code,cli,codex,developer-tools,open-source,scaffold,template
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# agent-repo-kit

New: tested TypeScript CLI and generated awesome-list templates. [Usage and examples](docs/maintenance-2026-09.md).

Scaffold launch-ready, AI-agent-friendly open-source repositories.

`agent-repo-kit` is a dependency-free Python CLI that creates repositories with the boring but important launch pieces already in place: README, AGENTS.md, license, CI, tests, contributing guide, security policy, issue/PR templates, roadmap, `.gitignore`, and `.gitattributes`.

## Why

Recent high-growth developer projects are clustered around AI coding agents, skills, context engineering, templates, and developer automation. A common gap remains: starting a repo that is ready for both humans and coding agents still takes repetitive setup.

This tool turns that setup into one command.

## Install

From this repository:

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

Or run without installing:

```bash
python -m agent_repo_kit list
```

## Usage

List templates:

```bash
agent-repo-kit list
```

Create a Python CLI project:

```bash
agent-repo-kit create my-tool \
  --template python-cli \
  --description "A useful developer CLI" \
  --author "Your Name"
```

Create an agent playbooks/docs repository:

```bash
agent-repo-kit create agent-playbooks \
  --template agent-docs \
  --description "Reusable AI coding agent playbooks"
```

Preview without writing files:

```bash
agent-repo-kit create my-tool --dry-run
```

## Templates

### `python-cli`

A standard-library Python CLI package with:

- `pyproject.toml`
- importable package
- console script
- unit test
- GitHub Actions CI across Python 3.10, 3.11, and 3.12
- launch-ready repo files

### `agent-docs`

A Markdown repository for reusable AI coding agent playbooks with:

- AGENTS.md
- code review playbook
- release playbook
- docs validation script
- GitHub Actions CI
- launch-ready repo files

## Generated Repository Standards

Every template includes:

- README
- AGENTS.md
- MIT license
- Contributing guide
- Security policy
- Code of conduct
- Roadmap
- GitHub Actions workflow
- Issue template
- Pull request template
- `.gitignore`
- `.gitattributes`

## Development

```bash
python -m pip install -e .
python -m unittest discover -s tests
python -m agent_repo_kit list
```

## Agent OSS Toolkit

This project is part of a small toolkit for building and launching agent-ready open-source repositories:

- [agent-repo-kit](https://github.com/Uky0Yang/agent-repo-kit): scaffold launch-ready, AI-agent-friendly repositories
- [oss-launch-check](https://github.com/Uky0Yang/oss-launch-check): audit whether a repository is ready to launch as open source
- [repo-context-card](https://github.com/Uky0Yang/repo-context-card): generate compact repository context cards for coding agents
- [agent-rules-lint](https://github.com/Uky0Yang/agent-rules-lint): lint AGENTS.md, CLAUDE.md, Cursor rules, and Copilot instructions
- [awesome-ai-agents-zh](https://github.com/Uky0Yang/awesome-ai-agents-zh): Chinese AI Agents / MCP / AI DevTools directory

## License

MIT
