Files
wild-pc/castle-api/CLAUDE.md
Paul Payne 930bc601b7 feat: add ComponentGrid and ComponentTable components for displaying components in grid and table formats
feat: implement HealthBadge and RoleBadge components for displaying health status and roles

feat: create LogViewer component for streaming logs of services

feat: develop SecretsEditor for managing secrets with CRUD operations

feat: introduce ToolCard component for displaying tool information

style: add global CSS variables and styles for consistent theming

feat: set up API client for handling requests to the backend

feat: implement hooks for fetching components, statuses, and tools

feat: create routes for dashboard, component details, and tools

feat: add service management endpoints for starting, stopping, and restarting services

feat: implement event bus for handling real-time updates via SSE

feat: create health check and logs endpoints for monitoring services

feat: add tests for health and tools endpoints to ensure functionality

chore: update project configuration files and dependencies for better development experience
2026-02-21 01:23:37 -08:00

876 B

CLAUDE.md

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

Overview

castle-api is a FastAPI service. Castle API.

Commands

uv sync                     # Install dependencies
uv run castle-api                 # Run service (port 9020)
uv run pytest tests/ -v     # Run tests
uv run ruff check .         # Lint
uv run ruff format .        # Format

Architecture

  • src/castle_api/config.py — Settings via pydantic-settings, env prefix CASTLE_API_
  • src/castle_api/main.py — FastAPI app, lifespan, health endpoint
  • tests/ — pytest with TestClient fixtures

Configuration

Environment variables with CASTLE_API_ prefix:

  • CASTLE_API_DATA_DIR — Data directory (default: ./data)
  • CASTLE_API_HOST — Bind host (default: 0.0.0.0)
  • CASTLE_API_PORT — Port (default: 9020)