docs: update nested READMEs in tools/, documents/, agents/ to reflect current contents

This commit is contained in:
2026-05-31 00:07:27 -05:00
parent 2a8c00f80b
commit e003865672
3 changed files with 52 additions and 13 deletions
+16 -2
View File
@@ -1,16 +1,30 @@
# Tools
Access guides for the third-party services and platforms AI agents need to work with in this environment.
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
@@ -21,4 +35,4 @@ Create a new `<toolname>.llm.md` file in this folder following the same pattern:
4. Common CLI/API patterns
5. Notes for AI agents
Then update `Tools/README.md` and the root `manifest.json`.
Then update `tools/README.md`, `README.md` (root), `llm.txt`, and `manifest.json`.