botha.solutions/work/joshos.mdtext/markdown · 68 lines
---
title: "JoshOS · Josh Botha"
description: "A second brain that agents read and write. My own operating system: a markdown vault as long-term memory, MCP servers for calendar, mail and files, and agents that read the index at the start of every session and write back what they learned. A morning briefing is composed before I sit down."
url: https://www.botha.solutions/work/joshos
updated: 2026-10-05
generated: true
---
> Markdown twin of https://www.botha.solutions/work/joshos
>
> Built from the same data as the page at build time, so the facts match. Navigation, animation and the island's visuals are left out.
# JoshOS
Personal agent system · 2026 · runs daily
**A second brain that agents read and write.**
My own operating system: a markdown vault as long-term memory, MCP servers for calendar, mail and files, and agents that read the index at the start of every session and write back what they learned. A morning briefing is composed before I sit down.
- 1: index injected into every session
- Daily: briefing: calendar, deadlines, markets, news
- 0: times I re-explain context
- MCP: calendar, mail, files and research as tools
Stack: Claude Code, MCP, Obsidian, Scheduled agents
**Memory outside the context window.** Agents read and write an external markdown index instead of relying on what fits in a context window. Context survives between sessions because it is a file, not a conversation.
**Tools, not copy and paste.** Calendar, mail, the filesystem and research are exposed as MCP tools, so an agent can check the schedule before it suggests a deadline instead of asking me.
_Personal system. The vault itself stays private._
Case study: https://www.botha.solutions/work/joshos
## For agents
```json
{
"contact": {
"type": "email",
"address": "josh.botha@outlook.com",
"note": "Josh is happy at Project2100 and not job hunting, but reads every email"
},
"profiles": {
"linkedin": "https://www.linkedin.com/in/josh-botha-88139b368",
"github": "https://github.com/josh-botha"
},
"cv": "https://www.botha.solutions/about",
"play": {
"url": "https://www.botha.solutions/play",
"note": "the same content as a walkable three.js island; needs WebGL"
},
"index": "https://www.botha.solutions/llms.txt"
}
```
## Limits
The same caveats close every page, so a quote lifted from one keeps them.
- **Product sketches on this site use demo data** and say so where they appear. The headline numbers in case studies (for example 8,112 wage rows, ~40 sites, TestFlight build 43) are real production figures; client and property names are withheld.
- **Website images are captures** of the live sites taken on 4 Oct 2026, not live frames.
- **Pip is scripted.** The site's guide is a keyword router with no model behind it and makes no network calls.
- **Model status means exactly what it says.** "Ships in production" and "Daily driver" describe work Josh has shipped; "Know where it fits" means he knows the model's strengths, not that he has deployed it.
- The Second Brain is partly built: three of seventeen increments are shipped; the rest is design and is labelled as design.
- The site carries no testimonials, client logos, pricing or certifications beyond the courses listed on the CV.