# Alhazen Core

> REQUIRED FIRST — starts TypeDB + dashboard via Docker, loads the Alhazen base schema. Must install before any other Alhazen skill. Use when this capability is needed.

- Skill: `tomevault-io/alhazen-core` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/alhazen-core`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/alhazen-core/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/alhazen-core

---


# Alhazen Core

**Install and initialize this skill before any other Alhazen skill.**

Starts the shared infrastructure via Docker Compose: TypeDB (knowledge graph database) + Dashboard (web UI for visualizing skill data). Loads `alhazen_notebook.tql` (the base schema that all domain skills extend).

**When to use:** First-time setup, infrastructure health checks, wiring skill dashboards, resetting the database.

## Prerequisites

- Docker must be running
- `uv` must be installed

## Quick Start

```bash
# Initialize TypeDB + dashboard (idempotent — safe to re-run)
uv run --project <skill-path> python <skill-path>/alhazen_core.py init

# Check status
uv run --project <skill-path> python <skill-path>/alhazen_core.py status
```

After init:
- TypeDB is available at `localhost:1729`
- Dashboard is available at `http://localhost:3001`

## Dashboard Workflow

The dashboard starts empty (just a hub page). After installing skills that have dashboards, wire them in and rebuild:

```bash
# 1. Wire a skill's dashboard into the container
uv run --project <skill-path> python <skill-path>/alhazen_core.py wire-dashboard \
    --skill-name jobhunt \
    --dashboard-dir /path/to/jobhunt/dashboard \
    --display-name "Jobhunt" \
    --icon Briefcase \
    --color indigo

# 2. Repeat for each skill with a dashboard...

# 3. Rebuild once (takes 30-60s)
uv run --project <skill-path> python <skill-path>/alhazen_core.py rebuild-dashboard

# 4. Check what's wired
uv run --project <skill-path> python <skill-path>/alhazen_core.py dashboard-status
```

When the user says "rebuild the dashboard", run steps 1-3 for each installed skill that has a `dashboard/` directory.

## Commands

| Command | Description |
|---------|-------------|
| `init` | Start TypeDB + dashboard, create database, load base schema |
| `load-schema FILE.tql` | Load additional schema into existing database |
| `wire-dashboard --skill-name X --dashboard-dir Y` | Copy skill's dashboard files into container |
| `rebuild-dashboard` | Rebuild Next.js inside dashboard container |
| `dashboard-status` | Show which skills are wired into the dashboard |
| `status` | Check TypeDB + dashboard container state |
| `reset --yes` | Drop and recreate the database (destroys data) |

**Read `USAGE.md` for troubleshooting and advanced usage.**

---
> Source: [sciknow-io/skillful-alhazen](https://github.com/sciknow-io/skillful-alhazen) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-15 -->