Metadata-Version: 2.4
Name: kosokoso
Version: 0.1.1
Summary: Create local AGENTS.md and CLAUDE.md aliases in Git repositories
License-Expression: WTFPL
Project-URL: Repository, https://github.com/uonr/kosokoso
Classifier: Environment :: Console
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# Kosokoso

Kosokoso (Japanese for “stealthily”) is a small script that creates `AGENTS.md` and `CLAUDE.md` links while preventing Git from tracking them.

For example, if a repository provides `CLAUDE.md` but not `AGENTS.md`, or vice versa, this script can quickly create a link for the missing file. If neither file exists, it uses `CONTRIBUTING.md` as the source for both links.

## Installation

Run it directly without installing anything:

```console
$ python3 kosokoso.py
```

Install it as an isolated command with uv:

```console
$ uv tool install kosokoso
```

You can also run it without installing it permanently:

```console
$ uvx kosokoso
```

With Nix:

```console
$ nix run github:uonr/kosokoso
```

## Usage

Run `kosokoso` from anywhere inside a Git repository:

```console
$ kosokoso
```

If you later want Git to track the generated links, remove their rules from the repository's local exclude file:

```console
$ kosokoso --track
```

This only removes the local exclude rules.
