Skip to content

v0.2.0 - Persistent Settings Configuration

Latest

Choose a tag to compare

@namastex888 namastex888 released this 31 Jul 22:21
· 4 commits to main since this release

πŸš€ Major Feature: Persistent Settings Configuration

This release introduces a significant improvement to configuration management by migrating from .env files to persistent JSON-based settings.

✨ New Features

  • Persistent Settings: Configuration now stored at ~/.automagik-cli/settings.json and persists across directory changes
  • First-Run Setup: Interactive setup dialog for new users with API server configuration
  • Automatic Migration: Existing .env files are automatically migrated to the new format
  • Default Configuration: Sensible defaults with localhost:8886 as the default API server

πŸ”§ Configuration Changes

  • BREAKING CHANGE: No longer reads .env files - configuration is now JSON-based
  • Settings persist globally in user home directory (~/.automagik-cli/settings.json)
  • Optional API key authentication (can be left empty for servers without auth)
  • All existing configuration options preserved and migrated automatically

πŸ“ New Components

  • SettingsManager: Robust JSON-based configuration management with atomic file operations
  • SettingsSetupDialog: Interactive first-run setup experience
  • Automatic .env to settings.json migration on first startup

πŸ”„ Migration Path

  1. Existing Users: Your .env file will be automatically detected and migrated to settings.json on first run
  2. New Users: Interactive setup dialog will guide you through initial configuration
  3. Configuration: Settings now persist regardless of which directory you run the CLI from

πŸ› οΈ Technical Improvements

  • Removed dependency on dotenv package
  • Added comprehensive error handling and recovery mechanisms
  • Atomic file operations prevent configuration corruption
  • Backward compatibility maintained for all existing functionality

πŸ“¦ Installation

npm install -g automagik-cli@0.2.0

🎯 What's Next

Your configuration is now more robust and persistent. The CLI will remember your settings across different projects and directories, providing a smoother user experience.

For detailed usage instructions, see the README.