docs: add llm.txt and manifest.json for LLM agent onboarding

2026-05-30 23:21:57 -05:00
parent b0916e3f09
commit ddd32e2303
2 changed files with 183 additions and 0 deletions
@@ -0,0 +1,61 @@
+# llm-tools
+
+This repository contains tooling, guides, and configuration resources for LLM agents (Codex, Claude, Cursor, etc.) working in Jacob Mathison's development environment.
+
+## What is this repo for?
+
+Developers and AI coding agents who need to:
+- Access the local self-hosted Gitea instance
+- Understand the project layout and available repositories
+- Bootstrap themselves into the local dev environment
+
+## Local Gitea Instance
+
+A self-hosted Gitea (v1.26.2) runs on the local Tailscale network:
+
+  URL:    http://100.79.253.19:3000
+  Owner:  jacob-mathison
+  Access: Tailscale VPN required (ask Jacob for an invite)
+
+To verify connectivity:
+  curl -s http://100.79.253.19:3000/api/v1/version
+
+To clone any repo:
+  git clone http://100.79.253.19:3000/jacob-mathison/<repo-name>.git
+
+To authenticate, generate a Personal Access Token at:
+  http://100.79.253.19:3000/user/settings/applications
+
+## Files in This Repo
+
+  llm.txt          This file. Plain-text overview for LLM agents.
+  manifest.json    Machine-readable index of repos, tools, and endpoints.
+  gitea.llm.md     Full Gitea access guide with API examples and auth setup.
+
+## Active Projects on Gitea
+
+See manifest.json for the full machine-readable list.
+
+Notable repos:
+  aarete-doczyai-app   Aarete DocyAI SaaS UI — document intelligence platform
+  llm-tools            This repo — LLM access guides and tooling
+
+## Environment Notes
+
+  - Tailscale network: devices named Orson, Hagia, Theodora, Tabitha, Ozymandias
+  - Gitea runs on Hagia (Seagate 8TB external drive) via Orson (Mac mini)
+  - CI/CD: Gitea Actions with act_runner on Orson (host mode, Node.js v24)
+  - LAN range: 192.168.12.0/24
+
+## Conventions
+
+  - Default branch: main
+  - Commit style: conventional commits (feat:, fix:, ci:, docs:, chore:)
+  - Node version: 20.x (LTS) for CI, 24.x on host
+  - Package manager: npm
+
+## Contact
+
+  Jacob Mathison
+  jacob@mathisonprojects.com
+  https://www.mathisonprojectsinc.com
@@ -0,0 +1,122 @@
+{
+  "schema": "llm-tools.manifest.v1",
+  "generated": "2026-05-30",
+  "owner": "jacob-mathison",
+
+  "gitea": {
+    "url": "http://100.79.253.19:3000",
+    "version": "1.26.2",
+    "api": "http://100.79.253.19:3000/api/v1",
+    "swagger": "http://100.79.253.19:3000/api/swagger",
+    "access": "tailscale",
+    "tailscale_ip": "100.79.253.19",
+    "tailscale_hostnames": ["Orson", "Hagia", "Theodora"],
+    "auth": {
+      "type": "pat",
+      "generate_url": "http://100.79.253.19:3000/user/settings/applications",
+      "header": "Authorization: token <PAT>",
+      "basic_auth": "jacob-mathison:<PAT>"
+    }
+  },
+
+  "repositories": [
+    {
+      "name": "llm-tools",
+      "full_name": "jacob-mathison/llm-tools",
+      "description": "LLM tooling, prompts, and local Gitea access guides for Codex / Claude / Cursor",
+      "clone_url": "http://100.79.253.19:3000/jacob-mathison/llm-tools.git",
+      "default_branch": "main",
+      "visibility": "public",
+      "tags": ["meta", "docs", "llm"]
+    },
+    {
+      "name": "aarete-doczyai-app",
+      "full_name": "jacob-mathison/aarete-doczyai-app",
+      "description": "Aarete DocyAI SaaS UI — document intelligence platform",
+      "clone_url": "http://100.79.253.19:3000/jacob-mathison/aarete-doczyai-app.git",
+      "default_branch": "main",
+      "visibility": "private",
+      "tags": ["react", "typescript", "nextjs", "saas"],
+      "ci": {
+        "workflow": ".gitea/workflows/ci.yml",
+        "runner": "orson-runner",
+        "jobs": ["build-and-lint", "security-audit"]
+      }
+    },
+    {
+      "name": "mp-banner-and-pyre",
+      "full_name": "jacob-mathison/mp-banner-and-pyre",
+      "description": "",
+      "clone_url": "http://100.79.253.19:3000/jacob-mathison/mp-banner-and-pyre.git",
+      "default_branch": "main",
+      "visibility": "private",
+      "tags": ["mathison-projects"]
+    },
+    {
+      "name": "mp-banner-and-pyre-migration",
+      "full_name": "jacob-mathison/mp-banner-and-pyre-migration",
+      "description": "",
+      "clone_url": "http://100.79.253.19:3000/jacob-mathison/mp-banner-and-pyre-migration.git",
+      "default_branch": "master",
+      "visibility": "private",
+      "tags": ["mathison-projects", "migration"]
+    },
+    {
+      "name": "mp-banner-and-pyre-web",
+      "full_name": "jacob-mathison/mp-banner-and-pyre-web",
+      "description": "",
+      "clone_url": "http://100.79.253.19:3000/jacob-mathison/mp-banner-and-pyre-web.git",
+      "default_branch": "main",
+      "visibility": "private",
+      "tags": ["mathison-projects", "web"]
+    }
+  ],
+
+  "infrastructure": {
+    "ci_runner": {
+      "name": "orson-runner",
+      "version": "v0.6.1",
+      "host": "Orson",
+      "mode": "host",
+      "node_version": "24.1.0",
+      "node_path": "/opt/homebrew/bin/node",
+      "labels": ["ubuntu-latest", "macos-latest", "node"]
+    },
+    "machines": [
+      {
+        "name": "Orson",
+        "role": "Gitea host, CI runner",
+        "os": "macOS (arm64)",
+        "tailscale_ip": "100.79.253.19",
+        "lan_ip": "192.168.12.138"
+      },
+      {
+        "name": "Tabitha",
+        "role": "Silma AI primary (OCPlatform, k8s)",
+        "os": "macOS (arm64)",
+        "tailscale_ip": "100.76.192.116",
+        "lan_ip": "192.168.12.236"
+      },
+      {
+        "name": "Ozymandias",
+        "role": "Travel laptop / coding box",
+        "os": "macOS (x86_64)",
+        "tailscale_ip": "100.115.222.5",
+        "lan_ip": "192.168.12.202"
+      }
+    ]
+  },
+
+  "conventions": {
+    "default_branch": "main",
+    "commit_style": "conventional-commits",
+    "node_version_ci": "20.x",
+    "package_manager": "npm"
+  },
+
+  "files": {
+    "llm.txt": "Plain-text overview for LLM agents",
+    "manifest.json": "This file — machine-readable index of repos, tools, and endpoints",
+    "gitea.llm.md": "Full Gitea access guide with API examples and auth setup"
+  }
+}