---
project: "kodi-agent"
version: "2.1.0-dev"
updated: "2026-04-12"
---

# KodiAgent — AI Agent Configuration System

KodiAgent is an autonomous AI agent configuration system for Kodi media center management and addon development. It runs via the Antigravity IDE and provides a fully self-documenting, self-improving, project-aware architecture.

## What it does

- **Kodi Management** — backup, restore, factory reset, addon installation, all via shell and JSON-RPC
- **Addon Development** — full development lifecycle: plan → implement → test → deploy
- **Documentation** — auto-generated, self-updating project documentation
- **Self-improvement** — automatic error analysis and configuration updates
- **Multi-OS** — adapts to macOS, Windows, Linux via `/change-os`

## Architecture

The system is built on three pillars in `.agent/`:

- **Rules** (13) — always-active or contextual behavioral constraints
- **Skills** (20) — specialized domain knowledge loaded on demand
- **Workflows** (18) — user-triggered `/command` sequences

All documentation follows a **project-based structure**: `docs/<type>/<project>/` where `<project>` is derived from conversation context (e.g. `plugin-video-milionar`, `kodi-agent`).

## Key design principles

- **Docs-first** — documentation is the primary source of truth, not codebase
- **Project-aware** — all paths use dynamic `<project>` and `<addon-id>` placeholders, no hardcoded addon names
- **Self-contained** — plans, issues, and features are written so any independent agent can use them
- **English config, Czech output** — `.agent/` files in English for LLM comprehension, ALL user-facing output in Czech
- **No redundancy** — every piece of information exists in exactly ONE authoritative place
- **Analysis ≠ fix** — audit and diagnostics generate reports only, fixes require explicit user approval
- **Token efficiency** — no tables in config files, no redundant sections, bullet lists over tables

## Requirements

- **IDE**: Antigravity (or any agent-capable IDE)
- **OS**: macOS (primary), Windows/Linux (via `/change-os`)
- **Kodi**: 21 Omega or later
- **Shell**: zsh (macOS), bash (Linux), PowerShell (Windows)

## Quick start

```
/help          — see what KodiAgent can do
/learn <topic> — load knowledge about a feature
/plan          — create implementation plan
/do            — execute approved plan
/audit         — check system integrity
```

## Documentation

- [STRUCTURE.md](STRUCTURE.md) — complete `.agent/` file tree
- [CHANGELOG.md](CHANGELOG.md) — version history
- [000-index.md](000-index.md) — feature index
