140 lines
5.8 KiB
Plaintext
140 lines
5.8 KiB
Plaintext
# llm-tools
|
|
|
|
This repository is a navigation phonebook for AI agents (Codex, Claude, Cursor, etc.) working in Jacob Mathison's development environment. It answers the core questions an agent needs to orient itself without asking or guessing.
|
|
|
|
## What is this repo for?
|
|
|
|
Developers and AI coding agents who need to:
|
|
- Access the local self-hosted Gitea instance or GitHub
|
|
- Understand what AWS resources exist and how to use them
|
|
- Connect to machines on the Tailscale network
|
|
- Access secrets via Vault or k8s services
|
|
- Find per-client and per-project context
|
|
- Know the conventions, machines, and services in this environment
|
|
|
|
## Start Here
|
|
|
|
New agent? Read documents/onboarding.md first — it sequences the full orientation checklist.
|
|
|
|
## Repository Structure
|
|
|
|
AGENTS.md Operational rules for AI agents working in this repo (read first)
|
|
README.md Full overview, structure tree, quick-start, environment at a glance
|
|
llm.txt This file. Plain-text summary for rapid LLM ingestion.
|
|
manifest.json Machine-readable index of all files, folders, repos, and services
|
|
|
|
tools/ Access guides for third-party services and platforms
|
|
README.md
|
|
gitea.llm.md Local self-hosted Gitea — clone URLs, PAT auth, API examples
|
|
github.llm.md GitHub (MathisonProjects + silmaai) — repos, PAT, CLI patterns
|
|
aws-cli.llm.md AWS account — profiles, S3, Amplify, CloudFront, Lambda
|
|
tailscale.llm.md Tailscale network — machine IPs, kittens bridge, connectivity
|
|
vault.llm.md Vault secrets — all credential paths, read patterns
|
|
k8s.llm.md k8s silma-ai stack — services, ports, kubectl patterns
|
|
local-llm.llm.md Local LLMs — Gemma-4-E4B (localhost:8080) + Gemma-4-26B (localhost:8081)
|
|
claude-cli.md Claude Code CLI — commands, flags, MCP, local LLM usage
|
|
codex-cli.md OpenAI Codex CLI — install, approval modes, AGENTS.md
|
|
cursor-cli.md Cursor IDE/CLI — agent mode, rules, MCP, Gitea integration
|
|
discord.md Discord bot — read/send channels, guild/channel IDs, raw API
|
|
|
|
agents/ Per-agent configuration, context, and notes
|
|
README.md
|
|
claude.md Anthropic Claude (Claude Code / API) — full config ✅
|
|
cursor.md Cursor IDE AI
|
|
codex.md OpenAI Codex / ChatGPT with code access
|
|
|
|
workflows/ Reusable workflows, automation scripts, and prompt chains
|
|
README.md
|
|
job-search/
|
|
linkedin.md LinkedIn job search, AMS candidate sourcing, outreach templates
|
|
indeed.md Indeed job search, alerts, applying, tracking
|
|
|
|
documents/ Project specs, architecture docs, written context
|
|
README.md
|
|
onboarding.md Start-here checklist for new agents — read this first
|
|
machines.md Full machine inventory with connection patterns and quirks
|
|
|
|
analytics/ Data sources, dashboards, reporting guides
|
|
README.md
|
|
|
|
clients/ Per-client context for active engagements
|
|
README.md
|
|
aarete.md Aarete Group — DocyAI SaaS platform
|
|
|
|
projects/ Internal and personal project context
|
|
README.md
|
|
silma-ai.md Silma AI — OCPlatform, k8s stack, repos
|
|
banner-and-pyre.md MP Banner and Pyre — 3-repo suite, Amplify deploy
|
|
|
|
## Local Gitea Instance
|
|
|
|
Self-hosted Gitea v1.26.2 on the local Tailscale network:
|
|
|
|
URL: http://100.79.253.19:3000
|
|
Owner: jacob-mathison
|
|
Access: Tailscale VPN required
|
|
|
|
Active Gitea repos:
|
|
aarete-doczyai-app Aarete DocyAI SaaS UI (private)
|
|
mp-banner-and-pyre Mathison Projects Banner and Pyre (private)
|
|
mp-banner-and-pyre-migration Migration layer (private)
|
|
mp-banner-and-pyre-web Web frontend (private)
|
|
llm-tools This repo (public)
|
|
|
|
## GitHub
|
|
|
|
MathisonProjects: https://github.com/MathisonProjects (public work, OSS)
|
|
silmaai: https://github.com/silmaai (Silma AI projects, mixed)
|
|
PAT: $GITHUB_PAT in credentials/secrets.env
|
|
|
|
## AWS
|
|
|
|
Account ID: 567637986724
|
|
IAM User: jacob_mathison (AdministratorAccess)
|
|
Default Region: us-east-1
|
|
Profiles: default, mp-mac-tabitha
|
|
|
|
## Tailscale Network
|
|
|
|
Tabitha (Silma primary): 100.76.192.116 (macOS arm64)
|
|
Orson / Hagia / Gitea: 100.79.253.19 (macOS arm64)
|
|
Ozymandias: 100.115.222.5 (macOS x86_64, offline)
|
|
Hunter WSL2: 100.118.15.20 (Linux, offline)
|
|
GoatLord (Aaron): 100.123.22.58 (Windows, offline)
|
|
Kittens token: silma-kittens-2026 port 8765 on all machines
|
|
Hunter static tunnel: creon.ngrok.app
|
|
|
|
## k8s Services (Tabitha, after port-forward)
|
|
|
|
PostgreSQL: localhost:5432 Redis: localhost:6379
|
|
Qdrant: localhost:6333 Vault: localhost:18200 (token: devroot)
|
|
MinIO: localhost:9000 Temporal: localhost:7233
|
|
Grafana: localhost:3000 Temporal UI: localhost:8233
|
|
|
|
## Vault Secrets (silma/ KV path)
|
|
|
|
discord, telegram, github/silma, github/hunter, aws, gmail, google
|
|
api-keys/gemini, api-keys/nvidia, api-keys/banner-pyre, openclaw
|
|
spotify, twitter/silma, twitter/blb, reddit/silma-paws, reddit/silma-claws
|
|
|
|
## Local LLMs (Tabitha — Metal accelerated)
|
|
|
|
Gemma-4-E4B: http://localhost:8080 (fast, OpenAI-compatible)
|
|
Gemma-4-26B: http://localhost:8081 (capable, OpenAI-compatible)
|
|
Start: cd /Users/Tabitha/.openclaw && npm run api:llm
|
|
Storage: ~/.cache/huggingface -> /Volumes/Theodora/models/huggingface
|
|
|
|
## Conventions
|
|
|
|
Default branch: main
|
|
Commit style: Conventional Commits (feat:, fix:, ci:, docs:, chore:)
|
|
Node (CI): 20.x LTS | Node (host): 24.x
|
|
Package manager: npm
|
|
IaC: AWS Amplify Gen 2 for frontend projects
|
|
|
|
## Contact
|
|
|
|
Jacob Mathison
|
|
jacob@mathisonprojects.com
|
|
https://www.mathisonprojectsinc.com
|