Skip to content
Back to search

symbiotic-ai

A symbiotic AI agent that remembers everything, challenges you, and extends your cognition.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/lout33--symbiotic-ai/badge.svg)](/listings/lout33--symbiotic-ai)

HTML

<a href="/listings/lout33--symbiotic-ai"><img src="/api/listings/lout33--symbiotic-ai/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

**Try without installing:** the [Personal AI Hub](https://symbiotic.makestudio.app/) gives you a chat-based setup that generates your files in minutes, with no terminal needed.

**Want it set up with you, 1:1?** I'll build your Guardian Angel with you in one screen-share session, and you keep the system. [Book the 1:1 setup](https://buymeacoffee.com/lout33/e/550948).

Hermes Agent (recommended)

Install Hermes, clone this repo as your workspace, then start Hermes inside it:

# 1) Install Hermes Agent
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc  # or: source ~/.zshrc

# 2) Clone your Symbiotic workspace
git clone https://github.com/lout33/symbiotic-ai ~/symbiotic-ai
cd ~/symbiotic-ai

# 3) Optional but recommended: use the Symbiotic voice globally in Hermes
mkdir -p ~/.hermes
cp SOUL.md ~/.hermes/SOUL.md

# 4) Start Hermes from inside the workspace
hermes

What goes where with Hermes: - `SOUL.md` -> global voice at `~/.hermes/SOUL.md` - `AGENTS.md`, `USER.md`, `NOW.md` -> live in your workspace/project root - Run `hermes` from that workspace so the agent starts with your current context

If you already have a `~/.hermes/SOUL.md`, merge it instead of overwriting it.

Claude Code / opencode quick installer

curl -fsSL https://raw.githubusercontent.com/lout33/symbiotic-ai/main/install.sh | bash

Manual clone

git clone https://github.com/lout33/symbiotic-ai
cd symbiotic-ai

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 236 lines · 2 findings marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Symbiotic AI
  2. **Your AI's context should belong to you, not a platform. Symbiotic AI keeps it in plain files you own.**
  3. Your identity, commitments, and current direction live in a handful of Markdown files you can read, edit, version, and carry to any model. Native platform memory is opaque, automatic, and locked to one vendor. This is the opposite: you own it, and it moves with you.
  4. Symbiotic AI is also a reference implementation of [AI for better thinking loops](https://thinkingloops.makestudio.app), a category built around the claim that AI can help people think better in ways that survive commitment, action, and review. See proof, methods, and adjacent workflows at [Thinking Loops](https://thinkingloops.makestudio.app).
  5. <a href="https://www.youtube.com/watch?v=tCFSz1vbY6s"><img src="https://i.ibb.co/mCcVCc1m/whiteboard-evolution.jpg" alt="Symbiotic AI Tutorial" border="0"></a>
  6. [Watch the tutorial](https://www.youtube.com/watch?v=tCFSz1vbY6s)
  7. ## Fastest start
  8. Install the `symbiotic-onboard` skill and run it. A short interview, then you own your files.
  9. ```bash
  10. gh skill install lout33/symbiotic-ai symbiotic-onboard
  11. ```
  12. Then invoke `symbiotic-onboard` in your agent and answer the questions. Full walkthrough (plus the manual path): **[Get your agent to understand you in 10 minutes](guides/getting-started.md)**.
  13. ## The System
  14. The system is simple on purpose: a small set of files that turns one useful session into ongoing context.
  15. | File | Purpose | Changes |
  16. |------|---------|---------|
  17. | `SOUL.md` | Agent personality, identity, values, how it thinks and talks | Monthly |
  18. | `USER.md` | Your profile: identity, psychology, wiring, mission, energy patterns | Monthly |
  19. | `AGENTS.md` | How the agent operates: protocols, tools, patterns, interventions | Weekly |
  20. | `NOW.md` | Current state: tasks, queue, log, active projects, deadlines | Daily |
  21. The agent reads all 4 at session start. Updates NOW.md as you work. The system gets smarter the longer you use it -- not because of AI improvements, but because the files accumulate real context about you.
  22. Want to scale beyond one main agent? See the **[Multi-Agent Hierarchy Guide](guides/multi-agent-hierarchy.md)** for a simple human -> orchestrator -> leads -> specialists pattern.
  23. ## Guides
  24. - **[Multi-Agent Hierarchy Guide](guides/multi-agent-hierarchy.md)** -- run a human -> orchestrator -> leads -> specialists system without losing clarity
  25. - **[HEARTBEAT Setup Guide](guides/heartbeat-setup.md)** -- add screen-aware accountability through OpenClaw, Telegram, and what-did-i-do
  26. ## What Makes It Different
  27. **It challenges you.** From a real conversation:
  28. > **AI:** "You find something valuable -> People want it -> You feel repulsed by the exchange -> You give it away for free -> You have no money -> Repeat. That's not idealism. That's self-punishment."
  29. **You own it.** Your context lives in plain files you control, not a vendor's black box. Read it, edit it, version it in git, and carry it to any model. Unlike native platform memory, nothing is opaque, automatic, or locked to one tool.
  30. **It acts.** Writes code, researches, creates files. Not just advice.
  31. **It evolves.** After 100+ sessions, your files contain hard-won insights about what works for you specifically. No generic advice. Your patterns, your bugs, your wins.
  32. ### Symbiotic AI vs native memory
  33. | | Native platform memory | Symbiotic AI |
  34. |---|---|---|
  35. | **Ownership** | Vendor owns it, lives in their account | You own it: plain Markdown files on your disk |
  36. | **Portability** | Locked to one platform | Runs on any model (Claude Code, Hermes, OpenClaw, opencode) |
  37. | **Transparency** | Opaque and automatic: you can't see or edit what it stored | You read, edit, delete, and version every line |
  38. ## Installation
  39. **Try without installing:** the [Personal AI Hub](https://symbiotic.makestudio.app/) gives you a chat-based setup that generates your files in minutes, with no terminal needed.
  40. **Want it set up with you, 1:1?** I'll build your Guardian Angel with you in one screen-share session, and you keep the system. [Book the 1:1 setup](https://buymeacoffee.com/lout33/e/550948).
  41. ### Hermes Agent (recommended)
  42. Install Hermes, clone this repo as your workspace, then start Hermes inside it:
  43. ```bash
  44. # 1) Install Hermes Agent
  45. curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 75 on GitHub
  46. source ~/.bashrc # or: source ~/.zshrc
  47. # 2) Clone your Symbiotic workspace
  48. git clone https://github.com/lout33/symbiotic-ai ~/symbiotic-ai
  49. cd ~/symbiotic-ai
  50. # 3) Optional but recommended: use the Symbiotic voice globally in Hermes
  51. mkdir -p ~/.hermes
  52. cp SOUL.md ~/.hermes/SOUL.md
  53. # 4) Start Hermes from inside the workspace
  54. hermes
  55. ```
  56. What goes where with Hermes:
  57. - `SOUL.md` -> global voice at `~/.hermes/SOUL.md`
  58. - `AGENTS.md`, `USER.md`, `NOW.md` -> live in your workspace/project root
  59. - Run `hermes` from that workspace so the agent starts with your current context
  60. If you already have a `~/.hermes/SOUL.md`, merge it instead of overwriting it.
  61. ### Claude Code / opencode quick installer
  62. ```bash
  63. curl -fsSL https://raw.githubusercontent.com/lout33/symbiotic-ai/main/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 100 on GitHub
  64. ```
  65. ### Manual clone
  66. ```bash
  67. git clone https://github.com/lout33/symbiotic-ai
  68. cd symbiotic-ai
  69. ```
  70. ## How It Evolves
  71. 1. **Week 1-2:** Fill in SOUL.md (who is the agent?), USER.md (who are you?), AGENTS.md (basic rules), NOW.md (what are you doing?)
  72. 2. **Month 1:** The agent starts noticing your patterns. NOW.md log grows. You learn what works.
  73. 3. **Month 2+:** Optional files appear as needed. Milestones accumulate naturally.
  74. 4. **Ongoing:** SOUL.md and USER.md get refined as you learn more about yourself and what agent personality works.
  75. ## Examples
  76. Not sure what filled-in files look like? The [`examples/`](examples/) folder has 3 complete setups showing what the system looks like after weeks of real use:
  77. - **[jamie/](examples/jamie/)** -- 22yo CS student juggling classes, internship apps, and a side project
  78. - **[sam/](examples/sam/)** -- 30yo mid-level dev focused on career growth and interview prep
  79. - **[morgan/](examples/morgan/)** -- 35yo marketing manager integrating AI into their workflow
  80. Each has all 4 files filled in with realistic data. Start from the root templates and make them yours.
  81. ## The Memory Log
  82. In NOW.md, the agent maintains a dated log of patterns, quotes, and insights:
  83. ```
  84. ### Jan 10
  85. - Avoided user call. Rescheduled twice. Pattern: building = safe, talking = scary.
  86. ### Jan 15
  87. - Had first user call. Quote: 'I've been building what I think they want instead of asking'
  88. ### Feb 1
  89. - Pattern confirmed: 3 weeks on feature nobody asked for. This is the 3rd time.
  90. ```
  91. ## Commands
  92. | Command | What it does |
  93. |---------|--------------|
  94. | `/start-day` | Morning kickoff. Sets MIT for the day. |
  95. | `/check-day` | Quick accountability check-in. |
  96. | `/end-day` | Evening review. Captures wins, lessons. |
  97. | `/reflect` | Deep reflection. Surfaces patterns. Creates journal entry. |
  98. Commands work manually or scheduled via cron. See `commands/README.md`.
  99. ## Optional Files
  100. The system grows with you. Just create the file. The agent discovers and uses it.
  101. ### Tier-1 Optional
  102. These are the first files to add after the core 4.
  103. | File | Purpose | When to Add |
  104. |------|---------|-------------|
  105. | `COMMITMENTS.md` | Said vs Did tracking | First optional file to add if you want stronger accountability, pattern detection, and "you said this before" interventions |
  106. | `WINS.md` | Shipped projects, milestones, pattern breaks | When you need evidence you're making progress |
  107. | `IDEAS.md` | Quick idea capture | When ideas come faster than you can act |
  108. | `LOG_ARCHIVE.md` | Archived memory logs from NOW.md | When NOW.md gets too long |
  109. ### Other Optional
  110. | File | Purpose | When to Add |
  111. |------|---------|-------------|
  112. | `JOURNAL.md` | Longer-form reflections | When sessions aren't enough depth |
  113. ## HEARTBEAT: Screen-Aware Accountability
  114. Optional. Your AI monitors your screen activity, compares it against your tasks in NOW.md, and pings you on Telegram when you drift.
  115. ```
  116. [14:30] DOING: VS Code - building landing page components
  117. SHOULD: Ship landing page
  118. Flow state. Keep going.
  119. ```
  120. ```
  121. [15:15] DOING: YouTube - watching programming streams (45 min)
  122. SHOULD: Ship landing page
  123. You know what you should be doing.
  124. ```
  125. Powered by [OpenClaw](https://github.com/openclaw/openclaw) + [what-did-i-do](https://github.com/lout33/what-did-i-do) screen tracker. **[Setup guide](guides/heartbeat-setup.md)**
  126. ## Interoperability
  127. One directory, multiple interfaces:
  128. | Framework | Config | Best For |
  129. |-----------|--------|----------|
  130. | [Hermes Agent](https://github.com/NousResearch/hermes-agent) | Put `AGENTS.md`, `USER.md`, and `NOW.md` in your workspace. Optionally copy `SOUL.md` to `~/.hermes/SOUL.md` for a stable global voice. Run `hermes` from the workspace root. | Full agent runtime: tools, memory, web, code execution, automation |
  131. | [OpenClaw](https://github.com/openclaw/openclaw) | Set `workspace` in `~/.openclaw/openclaw.json` | HEARTBEAT, Telegram, scheduled check-ins |
  132. | Claude Code | `~/.claude/CLAUDE.md` (concatenate the 4 files) | Deep coding sessions |
  133. | opencode | `~/.config/opencode/` or project root | Terminal-based sessions |
  134. ## What Goes Where
  135. | Question | Answer |
  136. |----------|--------|
  137. | "Will this change next week?" | Yes -> NOW.md. No -> the stable file it belongs to. |
  138. | "Is this about the agent or the user?" | Agent -> SOUL.md. User -> USER.md. |
  139. | "Is this a protocol or personality?" | Protocol -> AGENTS.md. Personality -> SOUL.md. |
  140. | "Not sure?" | Put it in NOW.md. Move it later. |
  141. ## Community
  142. [GitHub Discussions](https://github.com/lout33/symbiotic-ai/discussions) -- Ask questions, share your setup, propose ideas.
  143. **Show Your Symbiosis:** Post your configuration in [Show and tell](https://github.com/lout33/symbiotic-ai/discussions/categories/show-and-tell). Your SOUL.md personality, conversation screenshots, custom commands. Think r/unixporn but for AI agents.
  144. Want to contribute? See [CONTRIBUTING.md](CONTRIBUTING.md).
  145. ## Philosophy
  146. Symbiotic > Assistive. Challenge > Validate. Memory compounds. Ship ugly.
  147. ## The Ecosystem
  148. | Project | What it does |
  149. |---------|--------------|
  150. | [OpenClaw](https://github.com/openclaw/openclaw) | Personal AI assistant runtime. Powers HEARTBEAT, Telegram, cron. |
  151. | [what-did-i-do](https://github.com/lout33/what-did-i-do) | Passive screen tracker with Gemini Vision |
  152. | [writing-style-skill](https://github.com/lout33/writing-style-skill) | Make AI write like you |
  153. ---
  154. Created by [@lout33](https://github.com/lout33)
  155. ![GitHub stars](https://img.shields.io/github/stars/lout33/symbiotic-ai?style=social)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.