Metadata-Version: 2.4
Name: cli-wikia
Version: 0.12.0
Summary: Offline, pip-installable reference wiki for AI coding CLIs (Claude, DeepSeek, Copilot, ChatGPT, Gemini) with a search/read command.
Project-URL: Homepage, https://github.com/Alexander-Sorrell-IT/CLI-Wikia
Project-URL: Repository, https://github.com/Alexander-Sorrell-IT/CLI-Wikia
Author-email: Alexander Sorrell <codehunterextreme@gmail.com>
License: MIT License
        
        Copyright (c) 2026 Alexander Sorrell
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
License-File: LICENSE
Keywords: ai,chatgpt,claude,cli,copilot,deepseek,gemini,reference,wiki
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Documentation
Requires-Python: >=3.9
Provides-Extra: test
Requires-Dist: pytest; extra == 'test'
Description-Content-Type: text/markdown

# CLI Wikia

An **offline, pip-installable reference wiki** for AI coding CLIs —
Claude Code, DeepSeek, GitHub Copilot, ChatGPT/OpenAI, Gemini, and
Google Antigravity — with a single command to browse, search, read and
edit the docs.

It's more than a wiki: the bundled docs can also be used as **grounding
context for a local model** (`wikia ask`), so the same content works as a
reference *and* as a knowledge base you fully control and can edit.

## Install

```bash
pip install cli-wikia
```

## Usage

```bash
wikia models                       # list models + topic counts
wikia list claude                  # list Claude topics
wikia read claude hooks            # print a topic
wikia search "permission"          # search across all models
wikia search "mcp" --model claude  # search one model
wikia path claude                  # show where the files live (to edit them)
wikia ask claude "how do hooks work?"   # answer from the docs via a local model
```

## How it's organized

```
src/cli_wikia/wikis/
├── claude/       # populated (Claude Code docs)
├── deepseek/     # skeleton
├── copilot/      # skeleton
├── chatgpt/      # skeleton
├── gemini/       # skeleton
└── antigravity/  # skeleton
```

Each topic is a plain Markdown file. Add or edit files in a model's folder
and reinstall (`pip install -e .`) to update your local copy. Because the
repo is git-backed, **every revision of every doc is kept** in history.

## Status

- **Claude** wiki is fully populated.
- DeepSeek / Copilot / ChatGPT / Gemini / Antigravity are skeletons to be
  filled from each tool's CLI or official documentation.

## Keeping the docs fresh, hooks, and scheduling

```bash
# update — diff each model's sources (--help/--version, official docs, and the
# model's own self-report) against the last snapshot; --write accepts a new baseline
wikia update gemini
wikia update --all --write

# hooks — integrate the wiki into a tool
wikia hooks status                 # per-model integration status
wikia hooks enable claude --write  # Level 1: awareness block in the instructions file
wikia hooks manifest claude        # Level 2: generate an editable hook manifest
wikia hooks apply claude --write   # merge the manifest into the tool's settings
                                   # (existing hooks are preserved; a .bak-cli-wikia
                                   # backup is written first)
wikia hooks remove claude --write  # remove exactly the hooks apply installed

# schedule — auto-run `wikia update --all` on a systemd user timer
wikia schedule config --write      # create the config (interval, upgrade, enabled)
wikia schedule apply --write       # install/remove the timer to match the config
wikia schedule status
```

All mutating commands are dry-run by default; pass `--write` to apply.

## License

MIT — see [LICENSE](LICENSE).
