👥 Subsystem Deep Dive

buddy/

📁 buddy/ 📄 6 files

Tutorial: buddy

The project implements a persistent digital companion that lives in the terminal alongside the user. It uses deterministic generation to create a unique creature (like a duck or robot) based on the user's ID, renders it using dynamic ASCII art, and manages its lifecycle with idle animations, reactions, and AI context awareness.

flowchart TD A0["Deterministic Generation (Soul & Bones)"] A1["ASCII Sprite Renderer"] A2["Live Component & Animation"] A3["Context Injection"] A4["Feature Discovery & Teaser"] A2 -->|"Retrieves companion state"| A0 A2 -->|"Generates visual frames"| A1 A3 -->|"Injects companion info"| A0 A4 -->|"Checks existence state"| A0

Chapters

  1. Deterministic Generation (Soul & Bones)
  2. ASCII Sprite Renderer
  3. Live Component & Animation
  4. Context Injection
  5. Feature Discovery & Teaser

Generated by Code IQ

Files in this section

01_deterministic_generation__soul___bones_.md
Chapter 1: Deterministic Generation (Soul & Bones)
Welcome to the world of buddy! In this project, we are building a CLI companion that lives in your terminal.
02_ascii_sprite_renderer.md
Chapter 2: ASCII Sprite Renderer
In the previous chapter, Deterministic Generation (Soul & Bones), we learned how to conjure a unique digital soul from…
03_live_component___animation.md
Chapter 3: Live Component & Animation
In the previous chapter, ASCII Sprite Renderer, we built a "Paper Doll" system. We can generate a Duck, put a hat on it…
04_context_injection.md
Chapter 4: Context Injection
In the previous chapter, Live Component & Animation, we gave our companion a heartbeat. It can blink, wiggle, and stand…
05_feature_discovery___teaser.md
Chapter 5: Feature Discovery & Teaser
In the previous chapter, Context Injection, we connected our companion to the AI's brain, allowing it to "see" and "hea…