ishaan1013/shadow

Health v2 · maintenance only

Flags: no_releases

Adoption not part of the score

1496 stars · 178 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

Shadow is an open-source background coding agent that autonomously understands, edits, and contributes to existing GitHub codebases, generating branches, commits, and pull requests. It combines a real-time Next.js chat interface (terminal, file explorer, task tracking) with isolated execution environments, from local runs to hardware-isolated Kata QEMU micro-VMs orchestrated on Kubernetes.

Use cases

• run an AI coding agent in the background on my GitHub repo
• self-host an open-source alternative to cloud coding agents
• have an agent open pull requests with AI-authored commits on existing codebases
• execute long-running coding tasks in isolated sandboxed VMs
• chat with an agent in real time while it edits files and runs terminal commands
• automatically document a codebase with an auto-generated wiki
• build a searchable memory of repository-specific knowledge for an LLM agent

When to choose

• you want a self-hosted, open-source background coding agent rather than a closed cloud service
• your workflow is GitHub-centric and you want automated branch, commit, and PR generation
• you need strong isolation (Kata QEMU micro-VMs, Kubernetes) for untrusted agent execution
• you value full visibility into agent context, tool calls, and the file/terminal workspace

When to avoid

• you only need inline autocomplete or quick edits inside your IDE rather than autonomous background tasks
• you want a lightweight CLI agent without deploying Next.js, PostgreSQL, and optionally Kubernetes
• your code cannot be connected to GitHub or you cannot provide LLM provider API keys
• you need a fully offline agent with local-only models, since it targets hosted providers like Anthropic, OpenAI, and OpenRouter

Facets

application · maturity active

agent-framework chat-interface rag developer-tools artificial-intelligence large-language-models developer-tools self-hosted ai-coding-agent autonomous-agent github-integration code-generation pull-requests sandboxed-execution micro-vm kata-containers real-time-ui nextjs websocket multi-provider-llm background-tasks code-search turborepo ai-agents nodejs web-server kubernetes

Member repositories

For agents

markdown · JSON · MCP: product_card(name="ishaan1013/shadow")