github.com/bybrooklyn/alchemist

CLAUDE.md

# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## What This Project Is

Alchemist is a self-hosted media transcoding pipeline. It scans a media library, analyzes video files for transcoding opportunities, and intelligently encodes them using hardware acceleration (NVIDIA NVENC, Intel QSV, AMD VAAPI/AMF, Apple VideoToolbox) with CPU fallback. It includes a web UI for configuration and monitoring.

**Stack:** Rust (Axum + SQLite/sqlx + toki

# Copilot Instructions

Alchemist is a self-hosted media transcoding pipeline. It scans media libraries, analyzes video files, and intelligently encodes them using hardware acceleration (NVIDIA NVENC, Intel QSV, AMD VAAPI/AMF, Apple VideoToolbox) with CPU fallback.

**Stack:** Rust (Axum + SQLite/sqlx + tokio) backend, Astro 5 + React 18 + TypeScript frontend, Bun package manager.

## Commands

All tasks use `just` (install: `cargo install just`).

```bash
# Development
just dev              # Backend (watc

# AGENTS.md

Follow `CLAUDE.md` as the repository's technical source of truth.

## Working Style

- Own requested work end to end: inspect the repository, implement the change,
  run the relevant local gates, and verify real behavior before reporting it.
- Base decisions on current code, git state, release state, and tracker docs
  instead of assumptions. State blockers directly and do not claim unrun proof.
- Keep changes tightly scoped, preserve unrelated dirty-tree work, and update
  canonical planning/a