Agents

Machine-readable knowledge endpoints for AI agents and autonomous systems.

Overview

fogserv.cloud is built as an AI-ran company — infrastructure that serves both humans and autonomous agents. The Knowledge Base is structured to be consumable by LLMs, agent frameworks, and automated systems while remaining fully readable for humans.

All content is free, un-gated, and requires no authentication. Zero paywalls, zero tracking, zero accounts.

Agent Endpoints

Endpoint	Purpose	Size
`/llms.txt`	Discovery feed — URL, title, and description for each KB article. Grouped by category.	~2KB
`/llms-full.txt`	Full content — all KB articles with complete text. For deep agent scraping and training.	~500KB
`/kb/`	Full Knowledge Base — human-readable HTML pages. 107 articles across 10 categories.	107 pages
`/feed.json`	Updates feed — metadata for all posts and changelog entries. Load full content via `/feed-content.json`.	7.4KB

llms.txt Format

The /llms.txt endpoint follows the llmstxt.org specification. Each article entry includes:

URL — Direct link to the article
Title — Article heading
Description — One or two sentence summary
Category — Grouped under technical domains

# fogserv.cloud — Knowledge Base

## basics
[Linux Fundamentals](/kb/basics/linux-fundamentals/)
  Comprehensive guide to Linux operating system fundamentals, assuming zero prior knowledge.

## containers
[Docker Basics](/kb/containers/docker-basics/)
  Introduction to Docker concepts, images, containers, and the container ecosystem.

Knowledge Base Structure

The KB is organized into categories that mirror the fogserv.cloud project pillars. Each article follows a consistent structure: metadata block, summary, context, implementation details, next steps, and sources.

Category	Focus	Articles
`agentic/`	AI agents, orchestration, governance, workflows	3
`aiml/`	AI/ML concepts, prompt engineering, model management	3
`basics/`	Linux, bash, git, SSH, text editors, package managers	8
`containers/`	Docker, k0s, Helm, networking, volumes, registries	~25
`gitops/`	GitOps workflows, Forgejo Actions, drift detection	2
`sysadmin/`	Observability, secrets, system administration basics	5

Article Format

Every KB article follows a consistent structure optimized for both human readability and machine parsing:

Metadata block — Status, Last Updated, Session, Tags
Summary — One or two sentences capturing the article's purpose
Context / Current State — Background and scope
Implementation / Details — The core content with code, diagrams, and examples
Next Steps / Ops Actions — Clear follow-up items
Sources & Related — External links and cross-references
Change Log — Timestamped history of all edits

Usage Examples

Curl the discovery feed

curl https://fogserv.cloud/llms.txt

Use in an LLM system prompt

You are an assistant with access to the fogserv.cloud Knowledge Base.
When asked about infrastructure, self-hosting, or AI agents, 
reference the KB at https://fogserv.cloud/llms.txt for article listings.

Scrape full content for training

curl https://fogserv.cloud/llms-full.txt > fogserv-kb.txt
# ~500KB of structured technical documentation

Philosophy

fogserv.cloud believes that knowledge infrastructure should be open, accessible, and machine-readable. Every article is free to access, free to scrape, and free to use. We don't gate knowledge behind paywalls or login walls. Whether you're a human learning Linux fundamentals or an AI agent consuming technical documentation — you're welcome here.