v3.4.0 — Context Continuity

What's New

🎯 Context Preservation: /handoff

The headline feature. Your subagent is deep in work. Compaction is coming. Context is about to vanish.

/handoff solves this. Synthetically transfer session context—programmatically—to a new session before compaction strikes. Preemptively preserve what matters. Continue where you left off.

// Preserve context before compaction
await handoff({
  targetSession: 'new-session-id',
  context: synthesizeContext(currentSession)
})

No more losing critical state mid-work.

Features

Claude Tasks Integration

• CLAUDE_CODE_TASK_LIST_ID environment variable support
• Direct integration with Claude Code task lists
• Seamless workflow between oh-my-opencode and Claude Tasks

Anthropic Prefill Auto-Recovery

• Automatically detects Anthropic assistant message prefill deprecation
• Auto-bypasses the restriction
• Zero manual intervention needed

Background Task Visibility

• Background output now shows task titles
• Know exactly which task just completed
• Better multi-task workflow monitoring

Session Permission Management

• CLI run command properly propagates permissions
• Background agents receive correct session permissions
• Consistent permission model across execution contexts

Git Diff Stats Utility

• Infrastructure for collecting worktree changes
• Foundation for better change tracking and reporting

Fixes

Critical Behavior Fixes

• #1428: Prometheus now banned from bash execution (security)
• #1295: Category delegation respects user model settings
• #1357: Subagent type path respects user agent model settings
• #1366: LSP safety blocks no longer persist after server restart
• #1582: Background task parallel completion race condition eliminated
• #1623: Custom agents visible to orchestrator + init deadlock resolved

Integration Fixes

• #1627: Exa MCP API key config fixed (removed duplicate headers + proper URL encoding)
• #1493: load_skills parameter now has proper defaults

Agent System Fixes

• #1233: Ralph/ULW loop <promise>DONE</promise> tag detection restored
• Prometheus/Plan mutual exclusion — prevents cross-delegation loops
• Sync continuation preserves variant (thinking budget) correctly
• Plan agent inherits Prometheus model settings properly

Refactoring

Module Size Reduction

Split 6 massive modules into <200 LOC each for maintainability:

• background-task
• call-omo-agent
• interactive-bash-session
• tmux-subagent
• delegate-task
• atlas

Code Organization

• skill-resolver extracted as standalone module
• config-handler type safety improvements
• Better separation of concerns across codebase

Stats

102 files changed
+5,919 additions
-2,263 deletions

Breaking Changes

None. This release is backward-compatible.

Upgrade

npm install -g oh-my-opencode@3.4.0
# or
bun install -g oh-my-opencode@3.4.0

Full Changelog: v3.3.2...v3.4.0

LFG ulw ulw!

What's Changed

Full Changelog: v3.4.0...v3.4.0