# 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

  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
