██╗  ██╗██╗   ██╗███████╗████████╗██╗███████╗██╗   ██╗
██║ ██╔╝██║   ██║██╔════╝╚══██╔══╝██║██╔════╝╚██╗ ██╔╝
█████╔╝ ██║   ██║███████╗   ██║   ██║█████╗   ╚████╔╝
██╔═██╗ ██║   ██║╚════██║   ██║   ██║██╔══╝    ╚██╔╝
██║  ██╗╚██████╔╝███████║   ██║   ██║██║        ██║
╚═╝  ╚═╝ ╚═════╝ ╚══════╝   ╚═╝   ╚═╝╚═╝        ╚═╝

---

Kustify Agentic is a multi-agent autonomous coding assistant that runs in your terminal. It plans, writes, reviews and debugs code through a team of specialized agents — all powered by an authenticated Microsoft Copilot web session instead of a paid API key.

It works in two cooperating layers:

1. The bridge hooks a real Copilot browser session and exposes it locally as an OpenAI-compatible API.
2. The agent talks to that local API and does the actual work — thinking, planning, writing files and self-correcting.

A single command starts the bridge, waits for the session to be ready, then drops you into the agent.

How It Works

        ┌──────────────────────────────────────────────────────────┐
        │                      kustify (CLI)                         │
        └───────────────┬──────────────────────────┬───────────────┘
                        │                          │
                        ▼                          ▼
        ┌───────────────────────────┐   ┌──────────────────────────┐
        │   Bridge (browser hook)   │   │     Agent (the coder)     │
        │  - undetected Chrome      │   │  - Thinker  -> Planner    │
        │  - solves Turnstile       │◄──┤  - CodeWriter -> Reviewer │
        │  - JS WebSocket bridge    │   │  - Debugger -> Runner     │
        │  - Flask OpenAI API :5432 │   │  - writes + verifies code │
        └───────────────────────────┘   └──────────────────────────┘

Features

Feature	Details
Multi-agent pipeline	Thinker, Planner, Code Writer, Reviewer, Debugger, Command Runner
Plan-as-todo display	Each run shows a Claude-Code-style task list with live progress
Self-correcting	Writes code, compiles it, feeds real errors back to the debugger until it passes
Works on your project	Operates in the current directory, not an isolated sandbox
File tools	Read, edit, list and find files from your system
No API key	Uses a hooked Copilot web session through a local OpenAI-compatible API
One command	kustify starts the bridge and the agent together

The Agents

Agent	Responsibility
Thinker	Analyzes the request, identifies tasks, risks and files involved
Web Searcher	Synthesizes background knowledge for the task
Planner	Produces a numbered, step-by-step execution plan
Code Writer	Writes complete, runnable code per step
Code Reviewer	Scores correctness, bugs, security and quality
Debugger	Diagnoses failures and rewrites the code
Command Runner	Writes files, installs deps, runs and compiles code
Orchestrator	Coordinates all of the above into one loop

Installation

git clone https://github.com/kustbots/kustify-agentic
cd kustify-agentic
pip install .

This installs the kustify command. You also need Google Chrome installed (the bridge drives a real Chrome session via undetected-chromedriver).

For development:

pip install -e .

Usage

Start everything with one command:

kustify

What happens:

1. A Chrome window opens to Copilot and solves the initial challenge.
2. Kustify waits until the web session is hooked (you'll see a spinner).
3. The agent starts — type a request and let the agents work.

On first run, you may need to sign in / clear a CAPTCHA in the Chrome window. The session is persistent, so subsequent runs are faster.

Modes

Command	What it does
kustify	Start the bridge and the agent (default)
kustify --bridge-only	Run just the bridge (for use with other OpenAI-compatible tools)
kustify --no-bridge	Run just the agent (connect to an already-running bridge)
kustify --version	Print the version
python -m kustify	Same as kustify

In-app commands

Once the agent is running:

Command	Description
<request>	Ask the agents to build or change something
read <path>	Read a file from your system
edit <path>	Edit a file with AI assistance
list <dir>	List directory contents
find <pattern>	Find files matching a pattern
status	Check system status
memory	View agent memory
files	List workspace files
clear	Clear memory
help	Show help
quit	Exit

Configuration

Kustify reads a few optional environment variables:

Variable	Default	Description
KUSTIFY_API_URL	http://127.0.0.1:5432	Bridge API base URL
KUSTIFY_BRIDGE_PORT	5432	Port the bridge serves on
KUSTIFY_WORKSPACE	. (current dir)	Where the agent writes code
KUSTIFY_CHROME_VERSION	auto-detect	Pin a specific Chrome major version

Project Structure

kustify-agentic/
├── pyproject.toml            # Package metadata + `kustify` entry point
├── requirements.txt
├── README.md
├── LICENSE
└── kustify/
    ├── __init__.py
    ├── __main__.py           # python -m kustify
    ├── cli.py                # Unified entry: bridge -> wait -> agent
    ├── config.py             # Central configuration
    ├── app.py                # Interactive agent application
    ├── bridge/               # Copilot browser hook + local API
    │   ├── browser.py        # Chrome automation + JS bridge injection
    │   ├── server.py         # Flask OpenAI-compatible API
    │   ├── launcher.py       # Background start + readiness wait
    │   └── state.py          # Shared browser state
    ├── core/                 # Shared infrastructure
    │   ├── api_client.py     # Talks to the bridge
    │   ├── memory.py         # Roles, tasks, shared memory
    │   ├── logger.py
    │   ├── file_manager.py
    │   └── helpers.py
    ├── agents/               # The multi-agent team
    │   ├── base.py
    │   ├── thinker.py
    │   ├── web_search.py
    │   ├── planner.py
    │   ├── code_writer.py
    │   ├── code_reviewer.py
    │   ├── debugger.py
    │   ├── command_runner.py
    │   └── orchestrator.py
    └── ui/
        └── gui.py            # Animated terminal UI

Disclaimer

Kustify automates a Microsoft Copilot web session for personal, educational use. Automating a web product may be against its terms of service — use responsibly and at your own risk.

Contributing

Pull requests are welcome. Please open an issue first to discuss significant changes.

License

Licensed under the GNU General Public License v3.0.

---

Made with care by KustBots · Updates Channel · Support Group