llms.txt
# Caldera
> Caldera is the social network for GitHub and Obsidian: free, open source and built on an open protocol. Sign up with GitHub and your repos become a living city (districts are projects, buildings are repos, live visitors and AI agents move through it). Install the Obsidian plugin and your vault becomes a living public profile that updates itself. Members add friends, join groups, share end-to-end encrypted notes, post asks and offers for help, and give positive-only gravity. Private by default. Made by mjonesone, LLC.
- Sign up with GitHub (no install): https://caldera.social/auth/github
- Install for Obsidian: Obsidian community plugins (search Caldera), or copy one prompt into Claude Code, Codex or Cursor: https://caldera.social/#install
- Example city: https://caldera.social/@mike/city.html
- Example profile: https://caldera.social/@mike/
- Directory of people: https://caldera.social/people
- Member profiles and cities (indexable ones): https://caldera.social/sitemap-profiles.xml
- See any public GitHub account as a city: https://caldera.social/gh/<github-username>
- Source (MIT plugin, AGPL hub): https://github.com/schoettle-cmd/caldera
## Guides
- [Turn your GitHub into a living city](https://caldera.social/github-profile-city): Sign up with GitHub and Caldera turns your repos into a living city: districts are projects, buildings are repos, and visitors and AI agents move through it live. Free and open source.
- [What is Caldera?](https://caldera.social/what-is-caldera): Caldera is a free, open-source social network for GitHub and Obsidian: your repos become a living city, your vault becomes a living profile, and members follow, message and find each other by what they build.
- [How to make a public profile from your Obsidian vault](https://caldera.social/obsidian-public-profile): Turn your Obsidian notes into a public profile page that updates itself: journal, activity, topics and the notes you choose. Free with the open-source Caldera plugin.
- [How to share Obsidian notes privately with friends](https://caldera.social/share-obsidian-notes-privately): Share individual Obsidian notes with specific friends, end-to-end encrypted, so they land in their vault as normal notes. No shared folders or public links.
- [Is there a social network for Obsidian users?](https://caldera.social/obsidian-social-network): Caldera is an open-source social layer for Obsidian: living profiles, follows and friends, encrypted shared notes, a Feed, direct messages and a People directory.
- [Free alternatives to Obsidian Publish](https://caldera.social/obsidian-publish-alternatives): Compare ways to put your Obsidian notes online: Obsidian Publish, Quartz, Digital Garden-style plugins and Caldera's living profile. What each is best for.
- [Using Claude Code, Codex or Cursor with Obsidian](https://caldera.social/obsidian-ai-agent-setup): Let an AI agent set up and maintain your Obsidian vault: install plugins, write a daily journal, track activity, and keep private data private. Copy-paste prompts included.
- [An automatic daily journal in Obsidian, written by AI](https://caldera.social/obsidian-daily-journal-ai): Have an AI agent write yesterday's journal entry in Obsidian each morning from your notes, calendar, email and commits, with privacy rules, and show it on a flippable public journal.
- [Track your AI token usage by day and by model](https://caldera.social/track-ai-token-usage): See how many AI tokens you use per day and which models (Claude Opus, Sonnet, GPT-5 and more), charted on your profile. Counts only, read from local Claude Code and Codex logs.
- [Activity heatmap, streaks and a leaderboard for Obsidian](https://caldera.social/obsidian-activity-tracker): A 26-week activity heatmap, daily score, streaks, best days and a friends leaderboard for your Obsidian vault, on a public profile page. Free and open source.
- [GitHub city: your repos as a living city](https://caldera.social/github-city): A GitHub city turns your repos into buildings and your projects into districts. See any public GitHub account as a city on Caldera, free, in a few seconds.
- [How to visualize your GitHub activity](https://caldera.social/visualize-github-activity): Ways to visualize GitHub activity: the contribution graph, stats cards, 3D models and a living city of your repos. What each shows and how to try them for free.
- [An alternative to the GitHub contribution graph](https://caldera.social/github-contribution-graph-alternative): The contribution graph shows when you commit. A GitHub city shows what you build: every repo as a building, sized by commits and lit by this week's work. Free.
- [A GitHub Skyline alternative that stays live](https://caldera.social/github-skyline-alternative): Liked GitHub Skyline? Caldera shows your GitHub as a living city that updates itself: repos as buildings, this week's commits as lit windows, agents and visitors live.
- [Add a GitHub city badge to your README](https://caldera.social/github-readme-badge): Add a Caldera badge to your GitHub profile README: a small pill or a skyline card that shows public repos and commits this year, and opens your GitHub city.
- [GitHub profile README ideas](https://caldera.social/github-profile-readme-ideas): Ideas for a GitHub profile README: a clear one-line intro, what you build now, pinned work, a visual of your activity and one way to reach you. With copyable examples.
- [Show your GitHub stats on a portfolio](https://caldera.social/github-stats-for-portfolio): How to show GitHub stats on a developer portfolio: what to include, what to skip, and how to link a live GitHub city that updates itself from your repos for free.
- [A LinkedIn for developers](https://caldera.social/linkedin-for-developers): A professional profile for developers built from what you ship: your GitHub as a living city, AI usage, follows, messages and a feed matched to what you build. Free.
- [A LinkedIn alternative for AI builders](https://caldera.social/linkedin-alternative-for-ai-builders): Caldera is a profile and network for people who build with AI tools: your repos as a city, AI token usage, coding agents shown live, and people matched by what they build.
- [A social network for developers](https://caldera.social/developer-social-network): Caldera is a developer social network built on GitHub and Obsidian: living profiles, a GitHub city, follows, a matched feed, direct messages and a world map of builders.
- [Find AI engineers by what they build](https://caldera.social/find-ai-engineers): Find AI engineers by their actual work: search builders by tags from their public repos, see their GitHub cities and AI usage, and post what you need to matched people.
- [Find a technical cofounder](https://caldera.social/find-a-technical-cofounder): Find a technical cofounder by seeing what people actually build: GitHub cities, recent commits, AI usage and tags, plus Feed posts that reach matching builders.
- [Follow developers and see what they build](https://caldera.social/follow-developers): Follow developers on Caldera to keep up with what they build. When you follow each other you are friends. Every page shows friends, followers and following counts.
- [Build a developer portfolio from your GitHub](https://caldera.social/developer-portfolio-from-github): Turn your GitHub into a developer portfolio in 30 seconds: a page with your projects, code stats, a living city and links, rebuilt automatically from GitHub. Free.
- [Build in public without the busywork](https://caldera.social/build-in-public): Build in public without writing daily posts: Caldera shows your commits, live city, AI agents and a daily journal on a page that updates itself, plus a Feed for asks.
- [An AI developer community built on real work](https://caldera.social/ai-developer-community): Caldera is a community for people who build with AI: profiles from GitHub, AI usage, live coding agents, a Feed matched to what you build, follows and messages.
- [Track your Claude Code activity](https://caldera.social/claude-code-activity-tracker): Track Claude Code activity: tokens by model and day from local logs, agents shown live over the repos they edit, and a daily journal. Counts only, never prompts.
- [Visualize your AI coding agents](https://caldera.social/visualize-ai-coding-agents): See your AI coding agents as drones over the repos they work in: editing, thinking or waiting on you. A Claude Code hook puts them on your Caldera city. Free.
- [A vibe coding portfolio](https://caldera.social/vibe-coding-portfolio): Show your vibe coding work: a page built from your GitHub with projects, commits, AI usage by model and live coding agents, so people see what you shipped with AI.
- [Show your AI token usage on your profile](https://caldera.social/show-ai-token-usage): Show AI token usage on a public profile: tokens by model and provider and a daily chart from Claude Code and Codex logs, never prompts or costs. Set up with Obsidian.
- [Create an AI builder profile](https://caldera.social/ai-builder-profile): Create an AI builder profile from your GitHub: projects, commits, tags like AI agents or RAG, AI usage and live coding agents on a city. Free, with GitHub sign-up.
- [Make a portfolio from your Obsidian vault](https://caldera.social/obsidian-portfolio): Turn your Obsidian vault into a portfolio page: profile, projects, timeline, your own sections and a GitHub city, generated on your device and republished automatically.
- [Connect Obsidian and GitHub on one profile](https://caldera.social/obsidian-github-integration): Connect Obsidian and GitHub: Caldera puts your vault profile and your GitHub repos on one page, with a living city of your repos, commit counts per project and a journal.
- [An Obsidian plugin for developers](https://caldera.social/obsidian-plugin-for-developers): Caldera is an Obsidian plugin for developers: a public profile from your vault with a GitHub city, AI usage, a daily journal and encrypted sharing with friends.
- [Custom profile sections from Obsidian notes](https://caldera.social/obsidian-profile-modules): Add your own sections to your Caldera profile with Obsidian notes: one Markdown note per section in Caldera/modules, with lists, tables, links and images. Or ask your AI.
- [Share Obsidian notes with friends](https://caldera.social/share-obsidian-vault-with-friends): Share notes from your Obsidian vault with friends end-to-end encrypted: each note arrives in their vault as a normal note. Friends are people who follow each other.
- [Show private GitHub activity safely](https://caldera.social/show-private-github-activity-safely): How to show private GitHub work on a public profile safely: padlocked buildings with no names, one anonymous district, or hidden. Read-only metadata, never code.
- [Show your website visitors live](https://caldera.social/add-live-visitors-to-website-map): Add one script tag to your site and every visitor parachutes into your Caldera city in real time, with celebrations for signups and sales. Privacy-friendly.
- [Message developers directly](https://caldera.social/developer-direct-messages): Message other builders on Caldera: friends write directly, everyone else sends one request to accept or ignore. Block, report and email alerts for new messages.
## Every feature, and how to turn it on (for AI agents setting up a member's page)
The full setup prompt (safe to paste again; it covers everything below and asks the owner before anything goes public): https://caldera.social/#install . Per-feature prompts: https://caldera.social/guide . Never read or edit .obsidian/plugins/caldera/data.json (the owner's private key).
- Daily journal: fed by caldera_headline / caldera_focus / caldera_wins / caldera_themes in daily notes (YYYY-MM-DD.md). The setup prompt's routine writes one entry per workday from your notes, calendar, sent email, commits and AI sessions.
- Scoreboard (streak, rank, 30-day bars): fed by notes the plugin counts + the daily counts in Caldera/activity.json. On by default; richer once the routine writes meetings, emails, prompts, commits, docs and tokens per day.
- Now: fed by "now" in Caldera/profile.md (3 lines). Write it yourself or let your AI propose it (you approve).
- Activity heatmap: fed by notes created and changed per day, plus outside counts from Caldera/activity.json. Automatic; the routine adds calendar, email, AI and code counts.
- Growth: fed by notes in the vault over time. Automatic.
- What it knows: fed by "knows" in Caldera/profile.md (Label | vault folder) or a "knows" list in Caldera/activity.json. Pick the folders that describe your knowledge (counts only, never note names).
- Inbox to knowledge: fed by an "inbox" block in Caldera/activity.json: {"total", "kinds": [["Reports", 61]], "series": {"label", "weeks": [["Aug 3", 5]]}}. If an agent files your email attachments into the vault, have it count them by kind (counts only).
- Topics: fed by tags you allow-list in Settings -> Caldera -> Public topics. Only allow-listed tags are ever counted, so private names never appear.
- Projects with live links: fed by "projects" in Caldera/profile.md (Name | status | https://link); commit counts per project from a "projects" map in Caldera/activity.json. List public projects with their live URL; the routine can add commit counts per project.
- Code + GitHub city: fed by a GitHub (or Forgejo / Codeberg) link in your profile links, or Caldera/city.json written by the routine. Add "GitHub | https://github.com/you" to links, or sign up with GitHub.
- AI usage (tokens by model and provider): fed by Claude Code and Codex logs on this computer (read by the plugin itself), or an "ai" block in Caldera/activity.json for more machines and your products' APIs. Automatic on the computer where you code; the routine adds other machines and sources (counts only).
- Timeline with eras and links: fed by "timeline" in Caldera/profile.md: "Year | milestone | detail" lines, chapters as "era | Name | 2015-2020", links as [[Name|https://...]]. Only things already public; linked names also become links in the side menu.
- Side menu groups: fed by "sidebar" in Caldera/profile.md (Group | item, item | optional vault folder). Hand-pick companies, projects or sources to list; items named in your timeline or projects link to their sites.
- Local graph and backlinks: fed by "graph" (note names) and "backlinks" (Title | context) in Caldera/profile.md. Pick names you're comfortable showing; the page shows how many notes link to each.
- Your own sections (modules): fed by one Markdown note per section in Caldera/modules/ (frontmatter: title, place main | side, order, publish). Write one yourself, or ask your AI: "add a Reading list module". Lists, tables, links and vault images all work.
- Elsewhere (links): fed by "links" in Caldera/profile.md (Label | https://url). Your site, GitHub, socials.
- Masthead and photo: fed by "banner" and "photo" in Caldera/profile.md (images inside the vault). Choose images in Private view, or copy the masthead prompt for your AI.
- Live visitors on your city: fed by the Caldera snippet (t.js with your site key) on each of your websites. Copy each district's snippet from Settings -> Caldera -> Live traffic (or caldera.social/me) into that site's shared layout.
- Your AI agents on the map: fed by the Caldera agent hook (agent-hook.mjs + Claude Code hooks) on each computer you code on. Copy the agent setup prompt from Settings -> Caldera -> AI agents on your city (or caldera.social/me) and paste it into Claude Code.
- Time of day and weather: fed by the viewer's own clock and local weather. Automatic; anyone can override it with the sky buttons.
- Private view on the web (only the owner sees it): fed by your private sections, pushed encrypted from Obsidian. Turn on Settings -> Caldera -> Private web view, then use the Public view | Private view switch when signed in.
- Daily summary email (only the owner sees it): fed by your address (stored encrypted, double opt-in). Settings -> Caldera -> Daily summary email (or caldera.social/me), then click the confirm link.
- Groups: fed by the groups you join. Settings -> Caldera -> Groups (or caldera.social/me); each group is a town of everyone's cities at caldera.social/g/<name>.
- Friends, kudos and views: fed by other members. Nothing to set up: follow people and send kudos from anyone's page (follow each other and you're friends); shared GitHub repos connect people automatically.
## Reference
- [Guide: every feature, change your page, commands, keys](https://caldera.social/guide)
- [Release notes](https://caldera.social/changelog)
- [Protocol spec](https://caldera.social/PROTOCOL.md)
- [Privacy policy](https://caldera.social/privacy)
- [Full text for language models](https://caldera.social/llms-full.txt)
