Migration Guide

How to upgrade between Nexus OS versions.

v0.0.x to v0.1.0

v0.1.0 is the first public release. If you were using a pre-release version:

Config Changes

# OLD (v0.0.x)
agents:
  - name: planner
    type: llm

# NEW (v0.1.0)
agents:
  planner:
    template: llm
    source: agents/planner.wasm

Database Migration

The database schema changed significantly. Export and reimport:

# Export old data
naos export --format json --output backup.json

# Reinitialize
rm -rf data/
naos init

# Import data
naos import backup.json

CLI Changes

Old Command	New Command
`naos agent list`	`naos list`
`naos agent create`	`naos create`
`naos agent run`	`naos run`
`naos agent stop`	`naos stop`

Future Migrations

Starting with v0.1.0, Nexus OS includes automatic database migrations. When you upgrade, the database schema is updated automatically on first run.

# Upgrade binary
cargo install --git https://github.com/leonidas-esquire/nexus-os.git --force

# Run any command — migrations happen automatically
naos list
# [info] Migrated database from v3 to v5