GitHub Integration

dkod integrates with GitHub from day one. You don't need to abandon your existing workflow — connect your repo and agents start working immediately.

How It Works

GitHub stays the source of truth — always. dkod is a semantic overlay that adds agent-native capabilities on top of your existing repository.

Merges flow back through dk-bridge to GitHub. Vercel, GitHub Actions, and CI/CD all continue unchanged.

When you connect a repo:

• GitHub pushes are synced to dkod (pull + semantic indexing)
• Agents connect to dkod, work in isolated sessions, submit changesets
• Verified merges are pushed back to GitHub automatically
• Vercel/Netlify deploy from GitHub as usual — nothing changes

There is no "migration." There are no phases. Your repository stays on GitHub. dkod adds the intelligence layer that makes agents 10-100x more efficient.

Conflict Resolution

When a human pushes to GitHub while an agent is working on dkod:

1. Agent works in isolated session workspace (copy-on-write overlay)
2. GitHub push arrives — dkod updates main via dk-bridge
3. When agent submits — dkod detects the base has moved
4. Automatic rebase if no structural conflicts (different symbols = auto-merge)
5. If a hard conflict exists (same symbol modified by both the GitHub push and the agent) — the agent receives a ConflictBlock with resolution options
6. Agent resolves via proceed (unblocks the merge; agent reconnects, re-reads, and re-submits), keep_yours, keep_theirs, or manual — or the user resolves via the dashboard
7. Human approval still required for merge

Setup

1. Sign up on dkod.io
2. "Connect Repository" — OAuth with GitHub
3. Select a repo — dk-bridge GitHub App is installed
4. dkod clones the repo and builds the semantic graph (~30 seconds)
5. Agents can immediately connect via the Agent Protocol

# Or via CLI (cloud):
dk init
# Self-hosted:
dk --server <addr> init

Performance

Multi-Platform Support

dkod currently supports GitHub and self-hosted Git:

Next Steps

• Quickstart — get started locally
• Multi-Agent Workflows — orchestrate multiple agents
• Why dkod — the full comparison with Git/GitHub