8.4K ·GitHub
What is this?
It's the system-prompt builder capsule for Astrid OS (part of Unicity AOS) - it owns an agent's 'spark' identity, merges it with workspace and environment context, and assembles the resulting system prompt the LLM receives.
It's the system-prompt builder capsule for Astrid OS (part of Unicity AOS) - it owns an agent's 'spark' identity, merges it with workspace and environment context, and assembles the resulting system prompt the LLM receives.Is this a standalone app or part of something bigger?It's a capsule - a modular IPC service inside Astrid OS's capsule architecture, which the README compares to /etc/profile in a normal OS. It only runs as a component of Astrid OS/Unicity AOS, not on its own.
It's a capsule - a modular IPC service inside Astrid OS's capsule architecture, which the README compares to /etc/profile in a normal OS. It only runs as a component of Astrid OS/Unicity AOS, not on its own.How do I get it running?It isn't launched manually - it activates when Astrid OS emits a spark.v1.request.build event, then loads the stored identity from capsule KV state or auto-detects it from home://.config/spark.toml.
It isn't launched manually - it activates when Astrid OS emits a spark.v1.request.build event, then loads the stored identity from capsule KV state or auto-detects it from home://.config/spark.toml.Do I need Astrid OS to use this?Yes, it depends entirely on Astrid OS's capsule KV state and pub/sub IPC bus - it subscribes to topics like spark.v1.request.build and tool.v1.execute.saveidentity and has no independent runtime.
Yes, it depends entirely on Astrid OS's capsule KV state and pub/sub IPC bus - it subscribes to topics like spark.v1.request.build and tool.v1.execute.saveidentity and has no independent runtime.What happens the first time, before any identity is set up?If no identity has been saved yet, the assembled prompt includes onboarding instructions so the agent walks through picking a callsign, class, aura, signal, and core directives.
If no identity has been saved yet, the assembled prompt includes onboarding instructions so the agent walks through picking a callsign, class, aura, signal, and core directives.What identity fields get saved during onboarding?During onboarding the LLM calls saveidentity, which stores the callsign, class, aura, signal, and core directives, then writes a recovery copy to home://.config/spark.toml.
During onboarding the LLM calls saveidentity, which stores the callsign, class, aura, signal, and core directives, then writes a recovery copy to home://.config/spark.toml.How does this capsule talk to the rest of Astrid OS?Entirely through pub/sub IPC: it listens for events like spark.v1.request.build and tool.v1.execute.saveidentity, and publishes the assembled prompt on spark.v1.response.ready.
Entirely through pub/sub IPC: it listens for events like spark.v1.request.build and tool.v1.execute.saveidentity, and publishes the assembled prompt on spark.v1.response.ready.Why is it compared to /etc/profile?Like /etc/profile initializes a shell session, this capsule initializes an agent's identity and environment context at the start of each session, echoing the session ID back for loop correlation.
Like /etc/profile initializes a shell session, this capsule initializes an agent's identity and environment context at the start of each session, echoing the session ID back for loop correlation.What are similar projects?capsule-react, holaOS, rrsi, aos-ce, capsule-memory, qwen-code, spring-ai-alibaba, harness-sdk
capsule-react, holaOS, rrsi, aos-ce, capsule-memory, qwen-code, spring-ai-alibaba, harness-sdkWhich topics is it in?agent-os, system-prompt, state-machine, pubsub, key-value, event-driven, agentic, configuration, agent-framework, prompt-engineering, ai-agent, rust
agent-os, system-prompt, state-machine, pubsub, key-value, event-driven, agentic, configuration, agent-framework, prompt-engineering, ai-agent, rust