40 lines
2.0 KiB
Markdown
40 lines
2.0 KiB
Markdown
# 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 |
|
|
| [`discord.md`](./discord.md) | Discord (via Silma's bot) | Read/send messages · channel IDs · guild map · raw API |
|
|
|
|
## 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`.
|