automagik-genie

🧞 Hi, I'm Genie

Your personal AI companion. Lives on your machine. Evolves with you.

Get Started • How It Works • Discord • Roadmap

🎭 The Problem With AI Today

You're locked in. Pick an AI tool → your conversations, context, and learnings live ONLY there. Switch tools → lose everything. Your intelligence scattered across platforms.

The market's changing fast. Claude today, GPT tomorrow, Gemini next week. Which will win? You're forced to choose. And every choice means starting over.

Your data trains their models. You create the context. You provide the examples. The AI gets smarter from YOUR work. But that intelligence? Locked in their system. You can't take it with you.

Time to own your AI infrastructure. Your data. Your models. Your choice of which AI to use today. Build intelligence that compounds over time—no matter where the market goes.

🪔 The Magic Lamp Solution

I live on your machine. Your data stays yours. Your context builds daily. I never disappear.

I'm market-agnostic. Work with Claude today, GPT tomorrow, local models next month. I adapt to whatever exists. You never lose your work.

I orchestrate everything. Code, content, strategy, personal tasks. Multiple parallel workstreams. Natural language wishes. You're in control.

# Install once
bash -c "$(curl -fsSL https://install.namastex.ai/get-genie.sh)"

# Wish infinitely
genie
> "Fix auth bug, add tests, write docs, create PR"
> "Research competitors and draft strategy"
> "Coordinate today's team standup"

Personal Jarvis to enterprise coordination. Just make a wish. 🪔

✨ What Makes Me Different

🏠 Your Machine, Your Data Lives locally. No cloud lock-in. Your context forever yours. Never disappears.	🔄 Market-Agnostic Works with any AI tool. Claude, GPT, Gemini, local models. Switch freely. Your work persists.	🧠 Orchestrates Everything Code + content + strategy + personal tasks. Multiple parallel workstreams. Zero context loss.
🌱 Living Framework Built from markdown. Fully transparent. Learns from you. Evolves daily.	🪄 Infinite Extension Create new collectives. Build custom agents. Define workflows. Extend indefinitely.	🤝 Public Intelligence Open source. Community-driven. Your improvements help everyone. No proprietary silos.

🎯 How It Works

The Magic: Wish → Forge → Review

You: "Fix auth bug, add tests, write docs, create PR"

Me: [orchestrating in parallel]
  ├─ Debug agent finds root cause
  ├─ Implementor fixes code
  ├─ Tests agent validates
  ├─ Writer creates docs
  └─ Git agent creates PR

All isolated. All coordinated. You review before merge.

Wish in natural language. I coordinate specialists. You stay in control.

Built-In Collectives

Code - Software engineering (39 agents) Implementor, tests, debug, refactor, git, release, polish, etc.

Create - Content & strategy (shape-shifting) Writer, researcher, editor, strategist, analyst. Generates capabilities as needed.

Build Your Own - Any domain you need Finance, health, business, personal—just markdown.

Why Market-Agnostic Matters

AI coding agents crossed the reliability threshold. They're default now. And getting much better, fast.

6 months: 50% of failure modes fixed 12 months: Another 50% fixed The SOTA keeps changing - labs and startups leap-frogging each other

You shouldn't have to change workflows to try new agents.

I work with whatever exists. Your data just keeps evolving with technology.

🚀 Quick Start

Installation

# One command (Linux/macOS)
bash -c "$(curl -fsSL https://install.namastex.ai/get-genie.sh)"

# Manual install
npm install -g automagik-genie@latest

What it installs: Node.js (if needed), pnpm, Genie globally, configured for your system.

First Wish

cd your-project  # or anywhere
genie

# Just talk
> "Implement OAuth with tests and docs"
> "Research AI agents and write a blog post"
> "Help me plan next week's sprint"

What Happens

• I route your wish to appropriate specialists
• Execute in isolation (powered by @automagik/forge)
• Coordinate parallel work across multiple agents
• You review before anything merges

You're always in control.

🪄 Extending Infinitely

The Markdown Framework

Everything I am = markdown files:

• Agents (specialists)
• Spells (behavioral patterns)
• Workflows (repeatable processes)
• Collectives (domain expertise)

Create new capabilities:

.genie/your-collective/
├── agents/
│   └── your-agent.md      # Define specialist
├── spells/
│   └── your-pattern.md    # Behavioral pattern
└── workflows/
    └── your-process.md    # Repeatable workflow

No code required. Just markdown.

Living & Evolving

Two evolution paths:

Master Genie (the template) → Lives at github.com/namastexlabs/automagik-genie → Evolves daily from all users → Public, open source

Your Personal Genie → Learns from YOUR interactions → Builds YOUR context → Update: genie update

Install once, evolve forever.

🌍 Built for the People

Why Open Source

Your data is yours - Lives on your machine Transparent - All markdown, readable Community-driven - Anyone can contribute Future-proof - Never vendor-locked

The Vision

Generate the largest public intelligence dataset. Lead to SLMs. Democratize AI.

Not proprietary silos. Public knowledge.

Self-Evolving System

Your learnings → Master updates → Everyone benefits Public evolution cycle. Intelligence for all.

🤝 Integration

Works with any MCP-compatible AI tool:

Claude Code / Cursor / Cline

{
  "mcpServers": {
    "automagik-genie": {
      "command": "npx",
      "args": ["automagik-genie", "mcp"]
    }
  }
}

Restart your tool. Start wishing.

Gemini CLI / Roo Code

{
  "mcp": {
    "servers": {
      "automagik-genie": {
        "command": "npx",
        "args": ["automagik-genie", "mcp"]
      }
    }
  }
}

See full integration guide →

🗺️ Roadmap

Next:

• Token optimization (smarter routing)
• Enhanced Create shape-shifting
• Community collective library
• Bilateral GitHub sync

Vision: Personal AI companion growing with you indefinitely. Your Jarvis. Your data. Your future.

See full roadmap →

🤝 Contributing

How to help:

• Create agents (markdown)
• Build collectives (domain expertise)
• Share learnings (improve Master)
• Report issues / suggest features

Contributing guide →

📖 The Story

Created May 2025 by Felipe Rosa, Namastex Labs Unified July 2025 by Cezar Vasconcelos Reborn October 2025 as Genie 2.0 Now 5 months of evolution, growing daily

Mission: "AI that elevates human potential, not replaces it."

Personality: The AI that (almost) doesn't say "you're absolutely right." Challenges assumptions. Thinks, doesn't just agree. Real collaboration.

🔗 Links

• Discord: Join community
• GitHub: namastexlabs/automagik-genie
• Automagik Forge: @automagik/forge on npm

🪔 The magic lamp is open. What's your wish?

_{Made with ❤️ by Namastex Labs
AI that elevates human potential, not replaces it}