▣

## Models

Mixed

Configure the default chat model for agents. Advanced routing and house-wide model catalogs are still available below, but they stay out of the main path.

i
Mixed Scope
Agent-scoped tabs target the selected agent. Providers, Skills, Vibe, Tiles, and System stay house-wide.
Selected Agent

# Welcome to Home23

Let's get your AI operating system running. This takes about 2 minutes.

1 Providers
2 Create Agent
3 Launch

## Connect a Provider

Your agent needs at least one AI provider to think. OAuth is recommended — it's free with Claude Max or ChatGPT Plus and refreshes automatically.

Or enter API keys manually

## Create Your Agent

This will be your initial home primary agent — the default intelligence Home23 falls back to when a surface needs the house-level default.

## Ready to Launch

Here's what we set up:

Starting your agent launches the cognitive engine, dashboard, and harness. It takes about 10 seconds.

## Providers & API Keys

OAuth is the preferred way to authenticate with Anthropic and ChatGPT. It's free with a Claude Max plan or ChatGPT Plus/Pro subscription and refreshes automatically. Use API keys below for all other providers or as a fallback.

### OAuth Sign-in recommended

Anthropic (claude.ai)
Sign in with your Claude account for Sonnet / Opus access.
checking…

A new tab will open to Anthropic's OAuth page. After authorizing, copy the entire callback URL from your browser's address bar and paste it below.

Open OAuth page
OpenAI Codex (ChatGPT)
Sign in with your ChatGPT account for GPT-5 / Codex access without an API key.
checking…

The OAuth flow opens your browser automatically and completes via a loopback callback. Wait for the status to flip to Connected.

### API Keys

Stored in `config/secrets.yaml`. Use these for providers that don't offer OAuth, or as a fallback.

## Agents

Roster and runtime controls for each Home23 agent.

### Create Agent

Create a new runtime with its own ports, channels, workspace, and chat default.

This will be your home primary agent — the house-level default Home23 falls back to when a surface needs a primary. Its chat model becomes the initial system default.
1. Identity 2. Channels 3. Model
Agent Name * Lowercase, alphanumeric, hyphens only
Display Name
Owner Name
Timezone

Channels let you talk to your agent from external apps. These are optional — you can always chat directly from the dashboard.

Telegram Bot Token Get one from @BotFather on Telegram. You can add this later.
Owner Telegram ID Your numeric Telegram user ID
Default Provider
Default Model
Ports
Auto-assigned on creation

## Worker Library

Install reusable specialists that can diagnose, verify, summarize, and report back without running a standalone Home23 engine. This is where the house learns what each worker is for.

### What This Unlocks

### Install Specialist

Name
Worker Pack
Owner Agent

### Installed Specialists

### Available Worker Packs

### Try A Worker

Specialist
Requested By
Need

### Recent Proof Trail

### Terminal Use

`node cli/home23.js worker list` `node cli/home23.js worker create systems --template systems --owner jerry` `node cli/home23.js worker run systems "inspect the current live problem and produce a receipt"`

## Models

Pick the normal chat model for the selected agent. Advanced routing and house-wide model catalogs are still available below, but they stay out of the main path.

### Chat Default

The model this agent uses for normal chat unless a conversation explicitly picks another model.

Default Provider
Default Model

### Pulse Voice

Optional model override for the selected agent's dashboard remarks. Leave it aligned with chat unless the pulse needs a different voice model.

Provider
Model
Voice Prompt Editor Dashboard remark personality for this agent.
System prompt (remark voice)

How the dashboard voice talks. Tune this when the pulse remarks need a different personality.

Advanced Cognitive Routing Internal engine slots, primary models, and fallbacks.

Per-slot routing for the thinking engine. Each row is one internal model call path, with optional fallbacks for errors or rate limits.

House-Wide Catalog and Aliases Shared provider model lists and shortcut names.

### Available Models per Provider

House-wide model catalog. These are the models shown in evobrew and shared pickers across Home23.

### Aliases

House-wide shortcuts that any agent can use when resolving model names.

Alias | Provider | Model |
--- | --- | --- | ---

## Query

Defaults for the selected agent's Query tab. These seed the dropdowns when that dashboard loads; users can still override per-query.

### Default Query

Model
Depth

### PGS (Partitioned Graph Synthesis)

Enable PGS by default
Sweep Model
Synthesis Model
Default Depth

## Document Feeder

Configure what documents get ingested into your agent's brain and how they're processed. These settings target the selected agent and save to its `instances/<agent>/config.yaml`, with `configs/base-engine.yaml` acting only as the fallback default. Some changes hot-apply; others require that agent's engine to restart.

### Live Status

Started
—
Watchers
—
Files
—
Compiled
—
Quarantined
—
Pending
—
Converter
—

### Paths & Patterns

The orchestrator always watches the drop zone and the agent's workspace directory. Add additional paths here to ingest files from elsewhere on your machine.

Additional Watch Paths
Exclude Patterns (one per line, glob syntax)

### Frequency & Batching

Drives when pending documents are flushed from the ingestion queue to the live brain. Interactive uploads always trigger a debounced fast flush regardless of these settings.

Flush interval (seconds)
Batch size
Max chunk size (chars)
Chunk overlap (chars)

### Document Compiler

The compiler runs raw documents through an LLM to extract concepts, relationships, and insights before they enter your agent's brain. Disabling means documents go in as raw chunks — lower quality, more noise.

Enabled
Compiler Model

### Binary Format Converter

Uses MarkItDown (Python) to convert PDFs, DOCX, images, audio, and other binary formats to markdown before ingestion. Requires `pip install markitdown`. Vision model needs OpenAI API access.

Enabled
Vision Model
Python Path
Status
—
⚠️ Engine restart required

Some settings you changed need the selected agent's engine to restart:

### Drop Zone

Drag and drop files to ingest them into your agent's brain. Files land in the watched drop zone directory and are auto-processed within a second. Max 100MB per file, 20 files per upload.

Label (optional — groups uploads)
⬇
Drop files here or click to browse
Any format — text files go direct, binaries via the converter

## Skills

Shared skills are host-wide capabilities for all Home23 agents on this machine. Public skill settings live in `config/home.yaml`; credentials live in `config/secrets.yaml`.

### Skill Catalog

Use this to see what the shared skill system currently exposes, how healthy each skill is, and which ones need credentials.

### X Research

Read-only X/Twitter research uses its own X API bearer token. This is stored host-wide so any Home23 agent can use the skill without per-user shell setup.

Bearer Token No token configured
Watchlist Accounts
0
Default to quick mode Cheap pulse checks first unless a prompt explicitly asks for deeper research.
Save markdown artifacts by default Writes research summaries into the workspace report path automatically.
Clear stored bearer token on save

## Vibe

Controls the dashboard Vibe tile — CHAOS MODE image generation, archive rotation, and optional dream augmentation that pulls symbolic motifs from the agent's most recent dreams.

### Generation & Rotation

Auto-generate
Generation Interval (hours)
Rotation Interval (seconds)
Gallery Limit
Image Provider
Image Model

### External Sources

Additional directories of images to mix into the Vibe cycle. One absolute path per line (use `~/` for your home directory). Images from these folders are displayed alongside CHAOS MODE generations — sorted by file modification time, newest first.

Source Paths

### Dream Augmentation

When enabled, the vibe service reads the N most recent dreams from the agent's brain and extracts symbolic motifs. Motifs are woven into CHAOS MODE prompts as texture and atmosphere, never as the literal subject.

Enable dream augmentation
Dream Lookback
Extraction Method

## Tiles

Compose the Home dashboard without code changes. Layout controls the full Home tab. Custom tiles use reusable connections stored in `config/secrets.yaml`; tile definitions live in `config/home.yaml`.

### Layout

Drag rows to reorder the Home tab. Toggle visibility and set each tile's width.

### Tiles

Create custom weather, sauna, or advanced HTTP/JSON tiles.

Tile Builder
Title
Tile ID
Icon
Mode
Connection
Refresh (ms)
Default Width

### Connections

Reusable secret-backed connections for all custom tiles.

Connection Builder
Name
Connection ID
Type

## Agency — Autonomous Actions

The allow-list below is house-wide. The audit trails at the bottom show what the selected agent actually tried and executed.

### Global

Allow autonomous actions (master switch)
Global max/hour (safety cap)

### Actions

Toggle actions on/off, flip into dry-run (logs intent only, no side effect), adjust per-action rate limits. Changes hot-apply — no restart.

### Integrations

iOS Shortcut bridge enabled
Shortcut bridge URL

### Recent Actions

Live audit trail for the selected agent. Intent is logged before the handler runs; outcome after. Refreshes every 5s.

### Rejected Requests

Actions the selected agent tried but weren't in the allow-list. Worth watching — these are requests for new capabilities.

## System

Ports, embeddings, chat defaults, and maintenance actions.

### Ports

Evobrew Port
COSMO App Port
COSMO WebSocket
COSMO Dashboard

### Chat Defaults

Max Tokens
Temperature
History Budget
Session Gap (ms)

### Embeddings

Changing the embedding model or dimensions requires re-ingesting all documents. Existing brain embeddings become incompatible with the new model.

### Maintenance