How trossini02/aisland works
AIsland is a desktop lab for running one to ten AI agents in a configurable island simulation, watching their activity, and analyzing results. The main workflow runs from setup and model selection through simulation and live viewing to reports and run comparisons. The graph captures the documented workflow and sampled module relationships; several subsystems are represented by their exact source directories because their implementation files were not sampled.
Main entry points: controller.ts Run controller · App.tsx App screens · runs.ts Run service · mind.ts Agent mind
Components 20
Desktop app
- App screens
src/renderer/src/App.tsx - Run setup
src/renderer/src/screens/NewRun.tsx - Live island
src/renderer/src/screens/Live.tsx - Report and compare
src/renderer/src/screens/Report.tsx - Desktop IPC
src/shared/ipc.ts
Run orchestration
- Run service
src/main/runs.ts - Run controller
src/run/controller.ts - Run configuration
src/shared/config.ts
Agent cognition
- Agent mind
src/agents/mind.ts - Decision parsing
src/agents/decision.ts - Model providers
src/agents/providers
Island simulation
- World state
src/sim/world.ts - World generation
src/sim/worldgen - Agent tools
src/sim/tools - Laws and homes
src/sim/law
Run analysis
- Run storage
src/run/store.ts - Report analysis
src/run/tables.ts - Report schema
src/shared/report.ts - Browser replay
viewer/src/IslandReplay.tsx
Other components
- Run owner
Connections 24
- Run owner → App screens: uses
README.md - App screens → Run setup: opens setup
src/renderer/src/App.tsx - App screens → Live island: opens live
src/renderer/src/App.tsx - App screens → Report and compare: opens reports
src/renderer/src/App.tsx - Run owner → Run setup: configures run
README.md - Run setup → Desktop IPC: sends run settings
- Desktop IPC → Run service: dispatches requests
src/main/runs.ts - Run service → Run controller: starts runs
src/main/runs.ts - Run service → Model providers: selects providers
src/main/runs.ts - Run controller → World generation: generates island
src/run/controller.ts - Run controller → World state: creates world
src/run/controller.ts - Run controller → Agent mind: requests decisions
src/run/controller.ts - Agent mind → Decision parsing: parses decisions
src/agents/mind.ts - Decision parsing → Agent tools: queues actions
src/agents/decision.ts - Agent mind → Model providers: requests model output
src/agents/mind.ts - Run owner → Model providers: chooses model
README.md - Run owner → Live island: watches activity
README.md - Run controller → Run storage: persists run data
- Run owner → Report and compare: studies results
README.md - Report and compare → Desktop IPC: requests run results
- Report analysis → Run storage: reads run data
src/run/tables.ts - Report analysis → Report schema: builds report
src/run/tables.ts - Run owner → Browser replay: views replay
README.md - World state → Laws and homes: applies world rules
src/sim/law/homes.ts