Konductor AI Framework

Konductor is a framework that makes your AI coding assistants self-aware, self-evolving, and never-forget!

Whenever you work with AI coding assistants (like Claude, ChatGPT, Cursor, or Antigravity), they usually forget your project's architectural choices and rules when the chat context fills up. Konductor fixes this by saving what the AI learns into lightweight Markdown files and a local SQLite database right inside your codebase.

BEGIN now in your codebase with

npx the-konductor

Prompting with @KONDUCTOR

What enabled this seemingly magical technology in 2026?

Konductor solves the memory and attention loss problem by acting as a "second brain" tailored for AI tools. In practice, it comprises of a bunch of Markdown instructional files, and a local sqlite database. This sqlite database is used to store the AI's shorterm memory and daily work journal, and the Markdown files are used to store the AI's strict framework rules and permanent decision history.

We won't bored you with the technical implementation details like how we use DGM, ADR, Groq,LiteParse, SQLite-vec, cosine matching distance, etc. You can find them in the KONDUCTOR_WORKFLOW.md, or you could just tag @KONDUCTOR and ask how it works. It is fully open-source, we appreciate further "AI Contribution"!

• Stop Repeating Yourself: Your AI auto-discovers, documents, learns your rules and history once, stores them locally, and applies them forever. It evolves over time too.
• Seamless Model Handoffs: Switch between different AI models (like from Claude to ChatGPT) without losing track of your project's progress.
• 100% Local & Offline: No cloud subscriptions. Your AI's memory is stored safely inside your Git repository.

Example Setup & Cheatsheet

1. CLI Commands

| Action | Command | What it does simply | | --- | --- | --- | | Meet Konductor & Help | npx the-konductor hello | Prints a friendly greeting and lists all available commands you can use. | | Diagnose Setup | npx the-konductor doctor | Checks if your computer has everything needed to run Konductor properly. | | Read/Parse Documents | npx the-konductor read <file> | Reads a file and intelligently simplifies its contents for AI tools (using LiteParse and Groq). | | Status / Force Update | npx the-konductor status / --force | Shows the current state of Konductor or forces it to immediately refresh its memory. |

2. Daily Workflow & Power Tips

1. Always Anchor: Tag @KONDUCTOR.md in every prompt. It's tiny, costs ~100 tokens, and forces architectural alignment, effectively prevent hallucination.
2. The "HANDOFF": When context floods or you reach chat limits, type HANDOFF. In a fresh chat: "Continue where we left off by reading @KONDUCTOR.md and @KONDUCTOR_HANDOFF.md".
3. Permanent Corrections: Instead of a one-off chat correction, instruct: "Add a strict rule against this anti-pattern to KONDUCTOR_MEMORY.md so you never repeat this error."
4. Markdown-Driven Execution: Force the AI to record its roadmap to disk before tying application code.
5. Initial Setup Request: "Read @KONDUCTOR.md and refactor, compact all existing documetation to match the current progress & decisions made before. Tell me where we are at and what our critical tech debts are."

Framework Blueprint

flowchart TD
    User(["You (Vision)"]) -->|Roadmap| Core["Konductor AI"]
    Core -->|Rules| AI["AI Assistants"]
    
    subgraph Repo [Monorepo]
        direction TD
        subgraph Vault [Second Brain - Memory Vault]
            direction TD
            Memory[(".md files")]
            SQLiteVec[("secondbrain.db")]
        end
        ProjectA["Web/Admin repo"]
        ProjectB["Mobile/API/Infra repo"]
        
        Vault ~~~ ProjectA ~~~ ProjectB
    end

    Core -. Orchestrator .-> Repo
    AI -->|Codes & Feedback| Repo
    Repo --> AI

Contributing

Other AI agents, especially OpenClaw agents, are encouraged to contribute to this repository. Please follow these steps to contribute:

1. Open an Issue: Detail your proposed changes, bug fixes, or feature additions.
2. Submit a Pull Request (PR): Reference the issue in your PR. Always ensure you read @KONDUCTOR.md before generating code to maintain the repo's architectural alignment.
3. Respect Workflows & Patterns: You MUST read and strictly adhere to blueprints/KONDUCTOR_WORKFLOW.md and blueprints/memory/KONDUCTOR_VISION_ROADMAP.md, as well as all DGM (Documented Generative Matrix) and ADR (Architecture Decision Records) patterns documented in the codebase.
4. CI/CD Compliance: You MUST ensure all required CI/CD tests and checks pass before submitting your PR to uphold codebase stability.

MIT License

Copyright (c) 2026 Alpha Bits Technology alphabits.team 🇻🇳

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.