# Changelog

All notable changes to CodeCraft. Versions follow [Semantic Versioning](https://semver.org/);
until 1.0, minor versions may contain breaking changes.

## [0.1.0] – 2026-11-09

First public release.

### Agents and chat

- Agent loop with streaming, task lists, subagents (parallel and in the background, on other
  models), skills, slash commands, `AGENTS.md` / `CLAUDE.md`, automatic context compaction.
- Modes: **build**, **plan** (read-only) and **craft** (study a website, app, game or old
  program and build your own version, with visual comparison, clean room or deep mode),
  plus custom modes and subagents. Review loops per mode.
- Tools: files, shell with background processes, web fetch and search, LSP diagnostics after
  edits, OpenSCAD for 3D printing, Ghidra for old binaries, image generation (fal.ai), and an
  interactive **browser** (click, type, run JavaScript, screenshots, console errors; private
  network addresses are blocked).
- MCP servers (stdio and Streamable HTTP, elicitation, tools loaded on demand).
- Permissions per tool and per shell command pattern, modes *ask*, *auto*, *accept edits* and
  *bypass*; permission cards with diffs; questions from agents and MCP servers.
- Checkpoints and rewind, fork, regenerate, accept changes hunk by hunk, git worktrees per
  session, reasoning effort per message, voice input, `@file` mentions, attachments.
- Project memory (`.codecraft/memory.md`, written by the agent) and personal memory.
- Hooks before and after tool calls, on prompts and at the end of a turn.

### Models

- Anthropic natively and every OpenAI-compatible API (Gemini, OpenRouter, opencode,
  fal.ai, Ollama, vLLM, llama.cpp, LM Studio).
- Prices per model, concurrency limits per host and model, monthly budgets.
- **Model fallback** when a host is unreachable or a budget is used up.
- **Provider status**: every 5 minutes each provider's model list is checked (no tokens).

### Web app

- Installable PWA with push notifications (permissions, questions, finished turns) and a
  **share target**: text and links shared from other apps start a chat or go into a recent one.
- Guided start screen, file manager with previews (PDF, Office, 3D models, images), web
  terminal, image gallery, git panel.
- **Command palette** (Ctrl/Cmd+K) and keyboard shortcuts; **prompt templates** with
  placeholders (personal and global); sessions can be **pinned, archived and filed into
  folders**, grouped by date or project.
- Statistics: tokens, cache hits, time to first token, prefill and output speed and cost per
  request; cost and tokens per day, an activity heatmap of the last 14 days, tables per model,
  provider, mode, user and session. Optional **daily cost summary** as a push at 20:00.
- 15 colour themes, each light and dark; English and German.
- "What's new" after updates; admins see when a new release is available.

### Automations and integrations

- **Automations**: agents on a cron schedule from a Markdown job file, created by an agent,
  from a **template** or by hand; **incoming webhooks** start them (shared secret or
  Gitea/GitHub HMAC signature; the payload is passed to the agent).
- **API tokens** with full or read-only scope.
- **Prometheus metrics** at `/metrics` (own bearer token) and JSON logs
  (`CODECRAFT_LOG_FORMAT=json`).
- **Backups**: daily zip of database and config, keep 30, optional copy to any S3-compatible
  bucket; download from the settings.

### Terminal client

- `codecraft`: a full-screen terminal client like Claude Code or opencode. The agent loop,
  tools and history stay on your machine; models, modes, rules, skills and the theme come
  from the server, which counts usage and costs. Also runs **without a server**: a guided
  setup connects Anthropic, OpenAI, Gemini, OpenRouter, opencode or local servers (Ollama,
  LM Studio, llama.cpp/vLLM, detected automatically).
- No prebuilt binaries in this release: install it from source with
  `cargo install --locked --git https://git.familie-zink.org/zink/codecraft codecraft-cli`.

### Users and security

- Local accounts (Argon2) and single sign-on via OpenID Connect; admins and users, private
  folders per user, shared folders, read-only session sharing, audit log.
- Shell commands of non-admin users run in a bubblewrap sandbox.
- Multi-arch Docker image (amd64, arm64).

[0.1.0]: https://git.familie-zink.org/zink/codecraft/releases/tag/v0.1.0