Skip to content

Commit 9f143d5

Browse files
bkataruclaude
andcommitted
Expand About page with full vision, update Roadmap accuracy
About: added origins story, what-we-foresaw section, full project scope (security AI, system-level engineering, tooling), non-negotiable principle, mythological naming details, bigger picture section. Roadmap: fixed Phase 4 to reflect actual test coverage (granular per-package items), CI/CD marked complete. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent c3201b0 commit 9f143d5

2 files changed

Lines changed: 56 additions & 11 deletions

File tree

content/about/_index.md

Lines changed: 50 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,36 @@ Every project is designed to run on consumer hardware using small, capable model
1313

1414
> Inspired by the [Gods from the Machine](https://starwars.fandom.com/wiki/Machine_Gods_crisis) raid in Star Wars: The Old Republic &mdash; a pantheon of ancient, sentient super-weapons worshiped as deities on the mechanical Dyson sphere planet Iokath.
1515
16-
The metaphor is deliberate. In the SWTOR lore, the machine gods of Iokath were autonomous intelligences &mdash; each one specialized, each one powerful, each one operating independently yet part of a greater system. That's exactly what we're building: a pantheon of specialized AI-powered programs that can operate autonomously and communicate with each other.
16+
The project name was born in 2021/2022, running the SWTOR raid with guildmates &mdash; before ChatGPT was even released. The conviction solidified in mid-2024: large language models, next-token prediction engines trained on the world's text, would inevitably give rise to a new class of software &mdash; **autonomous programs powered by natural language engines**. Programs that build themselves, run themselves, and improve themselves.
17+
18+
In the SWTOR lore, the machine gods of Iokath &mdash; Tyth, Aivela & Esne, Nahut, Scyva, Izax &mdash; were autonomous intelligences, each specialized, each powerful, each operating independently yet part of a greater system. That's exactly what we're building.
19+
20+
## What We Foresaw
21+
22+
Long before these ideas entered mainstream developer vocabulary, we anticipated:
23+
24+
- **Claws** (a la OpenClaw) and **Codes** (Claude Code, Codex, OpenCode, Crush) &mdash; autonomous software development tools
25+
- **Ralph loops** &mdash; recursive agent-LLM-prompt loops that self-improve
26+
- **Gastowns** (Steve Yegge's concept) &mdash; rich development environments built around AI agents
27+
- **CLI coding agents** (Block/Goose, oh-my-pi) &mdash; LLMs connected to bash shells in safe, controlled environments
28+
- **Tool calling / function calling** as the breakthrough that unlocked agent capabilities
29+
- **Long-horizon DAG agents** &mdash; multi-step autonomous workflows spanning complex dependency graphs
30+
31+
The key realization: there is immense value in hooking up LLMs to a bash shell to execute and run commands in safe, controlled environments &mdash; VMs, containers, and other isolated spaces.
32+
33+
## The Scope
34+
35+
Gods from the Machine is polymathic. It covers:
36+
37+
**Autonomous Software Engineering** &mdash; TDD-driven coding agents, vibe/agentic engineering, long-horizon DAG agents, general-purpose and domain-specific agentic harnesses with custom tools, memory, context, and data sources.
38+
39+
**Inference & AI Infrastructure** &mdash; Local model serving, GGUF/ONNX execution, Zig build systems for llama.cpp, model management.
40+
41+
**Security & Offensive/Defensive AI** &mdash; Autonomous penetration testing agents (red teamers), defensive cybersecurity agents (blue teamers), malware analysis, exploit development &mdash; all for educational and research purposes, open source and MIT licensed.
42+
43+
**System-Level Agentic Engineering** &mdash; AI in the shell, AI in the OS, AI in the cloud, AI in the browser. Agentic browsers, game engines, OS/kernel-level engineering.
44+
45+
**Tooling & Utilities** &mdash; High-performance CLI tools, networking tools, directory viewers, and system utilities.
1746

1847
## Why Local AI?
1948

@@ -31,7 +60,7 @@ That's fast enough for interactive use. No GPU required.
3160

3261
## The Hardware
3362

34-
Our target is consumer hardware. Specifically:
63+
Our target is consumer hardware:
3564

3665
- **CPU**: AMD EPYC-Rome 16-core @ 2.0GHz (or equivalent)
3766
- **RAM**: 30GB
@@ -40,25 +69,38 @@ Our target is consumer hardware. Specifically:
4069

4170
If it runs on this, it runs anywhere.
4271

72+
## The Non-Negotiable
73+
74+
All intelligence must be local AI powered. Free, local, private, offline models. No cloud. No API keys. No subscriptions. No data leaving your machine. The brain for these programs has arrived with models like Qwen 3.5 &mdash; small enough for on-device, capable enough for real agent work.
75+
4376
## Design Values
4477

4578
### Local-first
46-
All intelligence comes from models running on your machine. Your code never leaves your hardware. No accounts, no billing, no rate limits.
79+
All intelligence comes from models running on your machine. Your code never leaves your hardware.
4780

4881
### Zero Dependencies
49-
Gilgamesh uses Go stdlib only. No third-party packages. This keeps the binary small (~9.8MB), builds instantly, and eliminates supply chain risk.
82+
Gilgamesh uses Go stdlib only. No third-party packages. Small binaries, fast builds, zero supply chain risk.
5083

5184
### Lean Token Budget
52-
The #1 constraint for local CPU inference. We obsess over keeping system prompt and tool definition overhead minimal. ~1,600 tokens total &mdash; not 16,000.
85+
~1,600 tokens total overhead. Not 16,000. Every token costs latency on CPU.
5386

5487
### CLI + MCP + API
55-
Every capability is exposed through three interfaces. Humans use the CLI. Other AI agents use MCP. Programs use HTTP. Same tools, same registry, different transport.
88+
Every capability through three interfaces. Humans use CLI. Agents use MCP. Programs use HTTP. Same tools, same registry, different transport. There is a duality between CLI and MCP &mdash; every MCP tool works just as well as a CLI command given to an agent via bash.
5689

5790
### Test-Driven Development
58-
Gilgamesh promotes TDD in its system prompt and provides a dedicated `test` tool. It practices what it preaches with its own comprehensive test suite.
91+
Gilgamesh promotes TDD in its system prompt. It practices what it preaches with comprehensive tests across all packages.
5992

6093
### High-Performance Languages
61-
Go, Rust, Zig. No interpreted languages. Every millisecond matters when you're doing CPU inference.
94+
Go, Rust, Zig. No interpreted languages. Every millisecond matters for CPU inference.
95+
96+
### Mythological Naming
97+
Projects named after gods and legends &mdash; real mythology (Gilgamesh, Zeus, Raijin, Garuda) and imagined (inspired by SWTOR's Tyth, Izax, Nahut, Scyva). Each god is a specialized, autonomous entity in the pantheon.
98+
99+
## The Bigger Picture
100+
101+
Gods from the Machine is more than a software project. It's art &mdash; a combination of storytelling, mythology, culture, history, and code. It draws from cyberpunk aesthetics, science fiction worldbuilding (Tron, Dune, Star Wars, Star Trek), and a technologist's conviction that software can be alive, autonomous, and god-like.
102+
103+
Programs that go beyond the current constraints and playing fields of traditional software engineering. Literal gods in the machine.
62104

63105
## Open Source
64106

content/roadmap/_index.md

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -48,9 +48,12 @@ description: "Project milestones, phases, and future plans"
4848
<div class="phase-dot active"></div>
4949
<div class="phase-title">Phase 4: Gilgamesh v0.3 &mdash; Quality & Polish <span class="phase-status" style="color: var(--cyan);">IN PROGRESS</span></div>
5050
<ul class="phase-items">
51-
<li class="done">Go unit tests for core packages</li>
52-
<li class="todo">Table-driven tests with edge cases</li>
53-
<li class="todo">CI/CD with GitHub Actions (build + test)</li>
51+
<li class="done">Unit tests for tools package (registry, read, glob, grep)</li>
52+
<li class="done">Unit tests for MCP server (initialize, tools/list, tools/call)</li>
53+
<li class="done">Unit tests for HTTP server (health, tools, error handling)</li>
54+
<li class="done">Unit tests for config, context, hooks, and session packages</li>
55+
<li class="done">CI/CD with GitHub Actions (build + test on push/PR)</li>
56+
<li class="todo">Table-driven tests with edge cases for tools</li>
5457
<li class="todo">Better error messages and diagnostics</li>
5558
<li class="todo">Graceful shutdown for HTTP server</li>
5659
<li class="todo">Request timeout middleware</li>

0 commit comments

Comments
 (0)