From ddd32e23037e258c88f6063d3a88aa13872182cd Mon Sep 17 00:00:00 2001 From: Jacob Mathison Date: Sat, 30 May 2026 23:21:57 -0500 Subject: [PATCH] docs: add llm.txt and manifest.json for LLM agent onboarding --- llm.txt | 61 +++++++++++++++++++++++++ manifest.json | 122 ++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 183 insertions(+) create mode 100644 llm.txt create mode 100644 manifest.json diff --git a/llm.txt b/llm.txt new file mode 100644 index 0000000..ff559d2 --- /dev/null +++ b/llm.txt @@ -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/.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 diff --git a/manifest.json b/manifest.json new file mode 100644 index 0000000..977afa4 --- /dev/null +++ b/manifest.json @@ -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 ", + "basic_auth": "jacob-mathison:" + } + }, + + "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" + } +}