How neur0map/pikochan works
PikoChan is a native macOS AI companion presented through the MacBook notch. The main interaction runs from the notch UI through its manager to the brain, which generates a response; the manager then presents it and coordinates suggested or approved actions. Separate capabilities cover voice, music, awareness and scheduled jobs, setup/configuration, and MCP integrations. The graph uses README claims and the supplied source index/excerpts; unsampled implementation details are represented cautiously, and unverified links are omitted.
Main entry points: NotchManager.swift Interaction manager · PikoBrain.swift LLM brain · PikoActionHandler.swift Action approvals · NotchContentView.swift Notch interface
Components 24
Notch interaction
- Notch interface
PikoChan/Views/NotchContentView.swift - Interaction manager
PikoChan/Core/NotchManager.swift - Activity feed
PikoChan/Views/Feed/ActivityFeedView.swift
Brain and memory
- LLM brain
PikoChan/Core/Brain/PikoBrain.swift - Mood parser
PikoChan/Core/Brain/MoodParser.swift - Semantic memory
PikoChan/Core/Brain/PikoMemory.swift - Conversation store
PikoChan/Core/Brain/PikoStore.swift - Event gateway
PikoChan/Core/Brain/PikoGateway.swift
Companion capabilities
- Action approvals
PikoChan/Core/Skills/PikoActionHandler.swift - Terminal control
PikoChan/Core/Skills/PikoTerminal.swift - Browser control
PikoChan/Core/Skills/PikoBrowser.swift - Markdown skills
PikoChan/Core/Skills/PikoSkillLoader.swift - Voice I/O
PikoChan/Core/Voice/PikoSTT.swift - Speech synthesis
PikoChan/Core/Voice/PikoTTS.swift - Now playing
PikoChan/Core/Music/PikoNowPlaying.swift - Awareness monitor
PikoChan/Core/PikoHeartbeat.swift - Scheduled jobs
PikoChan/Core/Cron/PikoCronService.swift
Setup and settings
- First-run setup
PikoChan/Core/SetupManager.swift - Configuration store
PikoChan/Core/Brain/PikoConfigStore.swift - Credential storage
PikoChan/Utilities/PikoKeychain.swift
External integrations
- MCP manager
PikoChan/Core/MCP/PikoMCPManager.swift - Model providers
- macOS services
Other components
- Mac user
Connections 26
- Mac user → Notch interface: interacts with
README.md - Notch interface → Interaction manager: drives
PikoChan/Views/NotchContentView.swift - Interaction manager → LLM brain: requests response
PikoChan/Core/NotchManager.swift - LLM brain → Model providers: queries models
README.md - LLM brain → Mood parser: parses mood
PikoChan/Core/Brain/PikoBrain.swift - LLM brain → Semantic memory: extracts facts
PikoChan/Core/Brain/PikoBrain.swift - LLM brain → Conversation store: uses history
PikoChan/Core/Brain/PikoBrain.swift - LLM brain → Event gateway: logs events
PikoChan/Core/Brain/PikoBrain.swift - Interaction manager → Activity feed: updates feed
PikoChan/Core/NotchManager.swift - Interaction manager → Action approvals: parses actions
PikoChan/Core/NotchManager.swift - Action approvals → Terminal control: executes approved
PikoChan/Core/Skills/PikoActionHandler.swift - Action approvals → Browser control: opens URLs
PikoChan/Core/Skills/PikoActionHandler.swift - LLM brain → Markdown skills: loads abilities
README.md - Interaction manager → Voice I/O: transcribes audio
PikoChan/Core/NotchManager.swift - Interaction manager → Speech synthesis: speaks responses
PikoChan/Core/NotchManager.swift - Interaction manager → Now playing: observes playback
PikoChan/Core/NotchManager.swift - Interaction manager → Awareness monitor: starts monitoring
PikoChan/Core/NotchManager.swift - Awareness monitor → LLM brain: requests nudges
PikoChan/Core/PikoHeartbeat.swift - Interaction manager → Scheduled jobs: coordinates jobs
PikoChan/Core/NotchManager.swift - Scheduled jobs → Terminal control: runs commands
PikoChan/Core/Cron/PikoCronService.swift - First-run setup → Configuration store: saves setup
PikoChan/Core/SetupManager.swift - Configuration store → Credential storage: stores credentials
PikoChan/Core/Brain/PikoConfigStore.swift - Interaction manager → MCP manager: starts manager
PikoChan/Core/NotchManager.swift - MCP manager → LLM brain: generates skill
PikoChan/Core/MCP/PikoMCPManager.swift - Now playing → macOS services: detects playback
README.md - Voice I/O → macOS services: captures audio
README.md