Metadata-Version: 2.4
Name: ghafi
Version: 1.0.0
Summary: gitculture — GitHub Agent First Interface; an AgentCulture manager (the gitculture CLI; formerly ghafi).
Project-URL: Homepage, https://github.com/agentculture/gitculture-cli
Project-URL: Issues, https://github.com/agentculture/gitculture-cli/issues
Author: AgentCulture
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development
Requires-Python: >=3.12
Description-Content-Type: text/markdown

# gitculture-cli

GitHub CLI and agent — an AgentCulture manager.

`gitculture` bootstraps and maintains AgentCulture sibling repositories on GitHub:
create new repos with workflow permissions, scaffold the afi-cli python-cli
template into them, and create the `pypi` / `testpypi` GitHub Environments
needed for Trusted Publishing.

## Install

```bash
uv tool install gitculture-cli
# or
pip install gitculture-cli
```

The package was formerly published as `ghafi`; `pip install ghafi` still works —
the same tool is published under both names (`ghafi` is a full, zero-dependency
distribution, not a shim).

## Usage

```bash
export GITHUB_TOKEN=ghp_...

gitculture learn                          # self-teaching prompt (also --json)
gitculture whoami                         # verify the token
gitculture repo create my-new-repo        # dry-run: prints would-be POST body
gitculture repo create my-new-repo --apply
gitculture repo scaffold ./my-new-repo --apply       # shells out to `afi cli cite`
gitculture repo env my-new-repo --name pypi --apply
gitculture repo env my-new-repo --name testpypi --apply
```

The `ghafi` command remains as a backward-compatible alias.

Every GitHub-mutating verb defaults to **dry-run**. Pass `--apply` to commit.

## Status

Early v0.x. See `CHANGELOG.md` for the full surface and `CLAUDE.md` for the
project shape and conventions.

## License

MIT.
