Gemini-Powered Runtime

Code that Writes Itself.

An open-source, local-first alternative to Claude Code built by Veoksha. It combines Google Gemini with the Agent Development Kit (ADK) to work inside your repositories, read files, run allowlisted commands, and edit safely under explicit permissions.

$pip install gemcode
gemcode_engine_v1
// GEMCODE BY VEOKSHASELF-HEALING AGENTAGENT MESHTOOL SYNTHESISAGENT HABITSA2A PROTOCOL// GEMCODE BY VEOKSHASELF-HEALING AGENTAGENT MESHTOOL SYNTHESISAGENT HABITSA2A PROTOCOL

The Cognitive Loop.

GemCode utilizes a continuous reasoning loop to navigate files, test hypotheses, and verify its own work before presenting a solution.

Agent Telemetry
tool_call: think("...")

The objective is to replace the legacy JWT implementation with secure session cookies.

1. I will write tasks via \`todo_write\` to structure the multi-step work.
2. I need to completely rewrite \`src/middleware/auth.ts\` using \`search_replace\`.
3. I will spawn a sub-agent via \`run_subtask\` to rewrite the mocked JWT tests in parallel.

Plan formulated. Continuing ADK loop.

GemCode Architecture.

01

Agent Mesh

In-process Multi-Agent

Native ADK sub-agents communicate via an Event Bus. Full session isolation per agent with automatic self-healing loops.

02

Self-Healing

Change → Verify → Fix

Code repairs itself. After mutations, GemCode runs tests/lint and auto-fixes failures in a closed verification loop.

03

Tool Synthesis

Self-evolving tools

The agent detects repeated patterns and creates new reusable scripts at runtime, stored in .gemcode/synthesized_tools/.

04

Agent Habits

habits_add(...)

Schedule recurring tasks (cron/interval/daily). Agents wake up autonomously to run tests, audits, or status checks.

05

A2A Bridge

Cross-machine agents

Expose and consume agents across different machines and networks using the Google A2A (Agent-to-Agent) protocol.

06

Progressive Learning

Auto-memory & Skills

Proactive memory auto-saves discoveries. Delegation learning remembers which agent succeeds. Skills self-improve.

07

Checkpoints

/rewind · /diff

Mutating tools create automatic checkpoints, allowing you to compare checkpoint vs workspace and roll back changes.

08

GemCode Runtime

gemcode kaira -C .

Optional always-on background scheduler daemon. Features a persistent job registry and external IPC.

09

IDE Bridge & MCP

gemcode ide --stdio

JSONL protocol on stdin/stdout for editor extensions, plus support for loading external toolsets via MCP servers.

Absolute Control.

SYSTEM SECURITY
> GEMCODE_PERMISSION_MODE = "STRICT"
> Enable maximum autonomy with GEMCODE_SUPER_MODE=1

GemCode is designed to fail-closed: reads are safe by default, and mutations are rigidly gated. Shell execution is allowlisted, and file writes require explicit approval via --yes or terminal HITL (Human-in-the-Loop) prompts. Switch to Super Mode when you want zero interruptions. Use --super or GEMCODE_SUPER_MODE=1 to bypass mutations, shell execution gates, ADK confirmation handoffs, AFC stdin prompts, attachment gates, and auto-trust on CLI.

Initialize
Sequence.

$pip install gemcode
An Open-Source Project by Veoksha