Configuration

Iris is configured through config/iris.php. All settings have sensible defaults.

Agent Settings

Setting	Default	Description
agent.model	claude-sonnet-4-5	Chat model
agent.max_steps	30	Maximum tool iterations per request

Context Settings

Setting	Default	Description
context.history_limit	50	Messages in context
context.recent_summaries	3	Summaries included

Summarization Settings

Setting	Default	Description
summarization.threshold	40	Messages before triggering
summarization.keep_recent	50	Messages to keep active
summarization.buffer	35	Buffer before summarizing
summarization.model	claude-sonnet-4-5	Summarization model

Memory Settings

Setting	Default	Description
memory.tier1_max	5	Max important memories
memory.tier2_max	7	Max semantic memories
memory.importance_threshold	0.80	Minimum for Tier 1
memory.similarity_threshold	0.38	Minimum for Tier 2

Scoring Weights

Memories are ranked: (semantic × 0.45) + (importance × 0.30) + (recency × 0.15) + (frequency × 0.10)

Extraction Settings

Setting	Default	Description
extraction.threshold	10	Messages between extractions
extraction.max_memories	6	Max per extraction
extraction.model	claude-sonnet-4-5	Extraction model

Consolidation Settings

Setting	Default	Description
consolidation.similarity_threshold	0.80	Minimum to merge
consolidation.days_lookback	1	Days to look back
consolidation.max_cluster_size	5	Max memories per merge

Run manually:

php artisan iris:consolidate-memories
php artisan iris:consolidate-memories --dry-run

Calendar Settings

Setting	Default	Description
calendar.cache_ttl	15	Cache duration (minutes)
calendar.event_horizon	7	Days ahead in context

Todoist Settings

Setting	Default	Description
todoist.cache_ttl	15	Cache duration (minutes)

Embeddings Settings

Setting	Default	Description
embeddings.model	text-embedding-3-small	OpenAI model