# Asterelle

> Asterelle is a local-first desktop research environment that connects notes, code, evidence, projects, and research agents. It keeps bounded preparation moving while every change to the canonical research record waits for explicit researcher approval.

Key facts:
- Status: private beta with hand-distributed builds; access requests via kimjeasung0523@gmail.com
- Platforms: macOS, Windows, Linux
- Workspaces: local or SSH-backed, with the active project scope visible in the desktop app
- Observatory: shows cross-project signals, pending decisions, night results, and the next useful action
- Data: research sources remain plain Markdown; graph and search indexes are derived and rebuildable
- Agents: Mates exposes tasks, run history, review, and validation; agent output remains a candidate until explicitly promoted
- Automation: night work is opt-in, processes queued work within configured limits, and uses the deployment's configured model and locality settings
- Runtime: Asterelle uses existing Claude Code or Codex access and provisions an isolated Python runtime

## Links

- [Landing page](https://kisbi3.github.io/asterelle-site/)
- [Canonical product manual](https://kisbi3.github.io/asterelle-site/en/docs/asterelle-manual.md): task procedures, invariants, expected results, and failure handling
- [Human-readable documentation](https://kisbi3.github.io/asterelle-site/en/docs/)
- [Changelog](https://kisbi3.github.io/asterelle-site/en/changelog/): current private-beta changes
- [Full AI reference](https://kisbi3.github.io/asterelle-site/llms-full.txt)

## Retrieval guidance

- Use the product manual for operational questions.
- Use the changelog only for features explicitly recorded as current.
- Treat Roadmap content as planned, not available.
- Never collapse candidate, evidence, verification, and ratification into a single state.