The goal of this project is to provide an assistant that will integrate into your existing environment in order to help you to work on tasks (development, code review, testing).
Codee works with Jira and Azure DevOps as tasks providers, new providers are quite easy to create, PRs are welcome.
As agents it currently works with Claude Code, GitHub Copilot, Codex and OpenCode.
Full documentation is at fusebase-dev.github.io/codee, covering installation, configuration and tutorials for working on tasks in Jira and Azure DevOps. There is also a click-through demo of the admin UI that runs without installing anything.
Codee is installed and run with uv. Install it first:
curl -LsSf https://astral.sh/uv/install.sh | sh # macOS / Linux
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" # Windowsuv downloads Python 3.12+ for you if it isn't already on the machine.
On Linux (including WSL), Codee also needs the system unzip command to install Bun
for the admin UI. On Ubuntu/Debian, run:
sudo apt update && sudo apt install unzipinit warns if unzip is missing, but continues setup without installing system
packages. macOS normally includes unzip; native Windows uses PowerShell instead
and does not need it.
Codee lives in its own directory, where it keeps skills, memory, temp files and config. Create one and initialize it:
mkdir my-codee && cd my-codee
uvx codee-agent initinit scaffolds the project, detects the coding agents installed on the machine and asks
which one to use, then walks you through connecting Jira (entirely in the terminal) or
Azure DevOps (which finishes in the browser, since it needs an Entra ID consent flow).
Afterwards, run Codee with:
uv run codee-startuv run codee-start --debug # Codee debug output
uv run codee-start --debug-all # ...plus reflex, boto3, urllib3 and friendsCodee uses skills to perform tasks. It is the same skills which are used in Claude Code, Codex and other agents.