llm-tools/tools/README.md

# Tools

Access guides for the external services, platforms, and CLI tools AI agents need to work with in this environment.

Each file covers one surface — authentication, available resources, and common CLI/API patterns.

## Guides

### Infrastructure & Services

| File | Surface | Key Info |
|------|---------|----------|
| [`gitea.llm.md`](./gitea.llm.md) | Local Gitea (self-hosted git) | `http://100.79.253.19:3000` · PAT auth · Tailscale required |
| [`github.llm.md`](./github.llm.md) | GitHub | MathisonProjects + silmaai · PAT in `credentials/secrets.env` |
| [`aws-cli.llm.md`](./aws-cli.llm.md) | AWS | Account `567637986724` · S3 · Amplify · CloudFront · Lambda |
| [`tailscale.llm.md`](./tailscale.llm.md) | Tailscale network | Machine IPs · kittens bridge · connectivity checks |
| [`vault.llm.md`](./vault.llm.md) | HashiCorp Vault | `localhost:18200` · token `devroot` · all secret paths listed |
| [`k8s.llm.md`](./k8s.llm.md) | Kubernetes (silma-ai) | Service map · ports · kubectl patterns · storage notes |

### AI Tools & Models

| File | Tool | Key Info |
|------|------|----------|
| [`local-llm.llm.md`](./local-llm.llm.md) | Local LLMs (llama.cpp) | Gemma-4-E4B @ `localhost:8080` · Gemma-4-26B @ `localhost:8081` |
| [`claude-cli.md`](./claude-cli.md) | Claude Code CLI | Install · commands · flags · MCP · local LLM wiring |
| [`codex-cli.md`](./codex-cli.md) | OpenAI Codex CLI | Install · approval modes · AGENTS.md · local LLM wiring |
| [`cursor-cli.md`](./cursor-cli.md) | Cursor IDE/CLI | Agent mode · rules · MCP · local LLM · Gitea integration |

## Adding a New Tool

Create a new `<toolname>.llm.md` file in this folder following the same pattern:
1. Service/account details
2. Authentication method
3. Available resources (list what exists)
4. Common CLI/API patterns
5. Notes for AI agents

Then update `tools/README.md`, `README.md` (root), `llm.txt`, and `manifest.json`.