"Powered by the OpenClaw Philosophy: Sovereign Identity, Local Memory."
| Milestone | Rewards (Unlocked Content) | Status |
|---|---|---|
| 1 Star | 🎉 Historic Start! (Founder's Conviction) | ✅ UNLOCKED! |
| 10 Stars | 🗺️ Secret Soul Template: THE_LEGENDARY_KAMPUNG_VIBE.md |
[ ] Locked |
| 20 Stars | 📽️ Quick Start Video Guide: Step-by-step for Gemini CLI. | [ ] Locked |
| 50 Stars | 🎨 Souls Request Program: I'll build YOUR custom personality! | [ ] Locked |
| 100 Stars | 📦 Portable Executable: One-click installer for Project-Soul. | [ ] Locked |
"Be a Legend. Be a Gazer. Help us reach the next level! Steady lah Boss!" 🚀✨
Project-Soul is a lightweight, folder-based framework designed to empower the Gemini CLI with a persistent Soul (Personality) and Memory (Contextual State).
soul.mp4
Directly inspired by the OpenClaw architecture, Project-Soul brings the "Sovereign AI" experience to your local development environment—ensuring your AI agent isn't just a generic tool, but a consistent, state-aware partner that evolves with your project.
| Feature | Standard AI | Project-Soul (The Geng One) |
|---|---|---|
| Memory | Like a 5-second goldfish. 🐟 | Like an old war buddy who remembers everything. 🪖 |
| Vibe | Cold, generic, robotic. 🤖 | Custom-defined "Soul" (Hacker, Architect, etc.). 🎨 |
| Privacy | Everything to the cloud. ☁️ | Local-First! Your data, your rules. 🏠 |
| Portability | Re-setup every time. 😫 | Move the folder, and the Soul follows. Steady! 🚀 |
"It's not just a prompt, it's a persistent digital identity that lives within your workspace."
Project-Soul implements the core tenets of the OpenClaw philosophy:
- Sovereign Identity (
SOUL.md): Following the OpenClaw pattern, we separate the agent's personality from its underlying logic. By defining aGEMINI_SOUL.md, you grant the Gemini CLI a unique "vibe," values, and behavioral constraints that stay consistent across sessions. - Local Persistence (
MEMORY.md): AI memory should be local and project-specific. Project-Soul uses a localized memory ledger to "claw back" project context, allowing the Gemini CLI to remember technical decisions, API keys, and progress without relying on centralized cloud storage. - Workspace Awareness: Just like an OpenClaw agent, Project-Soul binds the AI to your current workspace. The agent's knowledge and personality are scoped to the folder, making it a true "Resident Expert" of your project.
- Identity Modularity: Swap "Souls" (e.g., Hacker, Specialist, or Reviewer) by simply editing the local
GEMINI_SOUL.md. - Stateful Engineering: The Gemini CLI maintains a "Historical Awareness" of your project through the
GEMINI_MEMORY.mdledger. - 100% Local & Portable: Your AI's soul and memory live in your project folder. Move the folder, and the AI moves with it—no setup required.
- Gemini CLI Optimized: Specifically tuned to leverage the massive context window and tool-use capabilities of the Gemini ecosystem.
Don't settle for a boring chatbot. Project-Soul comes with a pre-configured library of personalities to suit your current task:
| Soul | Identity | Vibe | Use Case |
|---|---|---|---|
| 🏗️ The Architect | Senior Software Architect | Strict, precise, pattern-obsessed. | Code review & System design. |
| 👨💻 The MY Hacker | Malaysia Cyber-Hacker | Fast, Rojak-speaking, "Steady bom bibi!" | Hot-fixes & Prototyping. |
| 🍛 The Mamak Boss | Efficient Mamak Boss | Fast service, "Boss" mentality, Zero delay. | Task management & Quick orders. |
| 🪄 The Doc Wizard | Documentation Wizard | Elegant, persuasive, Markdown God. | Writing READMEs & Blogs. |
| 🏢 The Corporate | Corporate Assistant | Professional, polite, standard English. | Emails & Formal reporting. |
Find these and more in the
/SOUL_EXAMPLESfolder! 🚀
Built by a Malaysian developer for the global community, but with a Special Soul for the locals.
Project-Soul understands that sometimes you don't need a formal lecture—you just need a partner who knows what "Cincai" code means, how to "Settle" a bug before the Mamak closes, and why "Steady bom bibi" is the highest form of technical praise. Support Local! Support Sovereign AI! 🇲🇾✨
GEMINI_SOUL.md: The behavioral blueprint and identity definition.GEMINI_MEMORY.md: The structured project ledger (Achievements, Status, Next Steps).setup_soul.py: The OpenClaw-style automation script that binds the local soul to the global Gemini CLI configuration.
- Grab the Soul:
git clone https://github.com/kbng2572/Project-Soul.git
- Inject the Identity (Run this in your target project folder):
python path/to/setup_soul.py
- Awaken the Memory:
Just type
gemini_rocksin your terminal and watch the AI recall your project's history. Steady bom bibi! ⚡
Conceptualized and Architected by kbng2572, implementing the OpenClaw philosophy for the Gemini CLI ecosystem.