Complete reference for Andromeda's command-line interface.

Latest Version: v0.1.0-draft12 includes new cron functionality and improved formatter! See the upgrade command to get the latest features.

Synopsis

andromeda [COMMAND] [OPTIONS] [ARGS...]

Commands

run

Execute JavaScript or TypeScript files.

Syntax:

andromeda run [OPTIONS] <FILES...>

Arguments:

• <FILES...> - One or more files to execute

Options:

• -v, --verbose - Enable verbose output showing detailed execution information
• --no-strict - Disable strict mode (allows more lenient JavaScript parsing)

Examples:

andromeda run script.ts

# Run multiple files
andromeda run utils.js main.ts helper.ts

# Run with verbose output
andromeda run --verbose my-app.ts

# Run without strict mode
andromeda run --no-strict legacy-script.js

repl

Start an interactive Read-Eval-Print Loop.

Syntax:

andromeda repl [OPTIONS]

Options:

• --expose-internals - Expose Nova internal APIs for debugging
• --print-internals - Print internal debugging information
• --disable-gc - Disable garbage collection

Examples:

# Start basic REPL
andromeda repl

# Start REPL with debugging features
andromeda repl --expose-internals --print-internals

# Start REPL with GC disabled (for debugging)
andromeda repl --disable-gc

REPL Commands:

• help - Show available commands
• history - Display command history
• clear - Clear the screen
• gc - Manually trigger garbage collection
• exit or quit - Exit the REPL

compile

Compile a JavaScript/TypeScript file into a single-file executable.

Syntax:

andromeda compile <INPUT> <OUTPUT>

Arguments:

• <INPUT> - Path to the source file to compile
• <OUTPUT> - Path for the output executable

Examples:

# Compile a TypeScript file
andromeda compile my-app.ts my-app.exe

# Compile to a Unix executable
andromeda compile script.js ./my-tool

# Compile with full paths
andromeda compile /path/to/source.ts /usr/local/bin/mytool

fmt

Format JavaScript and TypeScript files.

Syntax:

andromeda fmt [PATHS...]

Arguments:

• [PATHS...] - Files or directories to format (optional, defaults to current directory)

Examples:

# Format specific files
andromeda fmt script.ts utils.js

# Format entire directory
andromeda fmt src/

# Format current directory
andromeda fmt

# Format multiple directories
andromeda fmt src/ tests/ examples/

Supported File Types:

• .js - JavaScript files
• .ts - TypeScript files
• .jsx - JavaScript with JSX
• .tsx - TypeScript with JSX
• .json - JSON files

Global Options

These options are available for all commands:

• -h, --help - Show help information
• -V, --version - Show version information

Examples:

# Show general help
andromeda --help

# Show help for specific command
andromeda run --help

# Show version
andromeda --version

File Types

Andromeda supports these file extensions:

*JSX not actually supported yet

Environment Variables

Andromeda respects these environment variables:

Examples:

# Enable debug logging
RUST_LOG=debug andromeda run script.ts

# Disable colors
NO_COLOR=1 andromeda run script.ts

Debugging

Verbose Output

Use --verbose with the run command to see detailed execution information:

andromeda run --verbose script.ts

This shows:

• File loading times
• Parse times
• Execution times
• Memory usage
• Extension loading

REPL Debugging

Start REPL with debugging options:

andromeda repl --expose-internals --print-internals

This provides access to:

• Nova engine internals
• Garbage collection stats
• Detailed execution traces

Error Reporting

Andromeda provides detailed error messages with:

• File location and line numbers
• Syntax highlighting
• Suggestions for fixes
• Stack traces with source context

Examples

Basic Script Execution

# Simple execution
andromeda run hello.ts

# Multiple files with dependencies
andromeda run utils.ts main.ts

andromeda run complex-app.ts

Development Workflow

# Format code
andromeda fmt src/

andromeda run src/main.ts

# Test in REPL
andromeda repl

# Create production executable
andromeda compile src/main.ts dist/my-app

CI/CD Integration

config

Manage Andromeda configuration files.

Syntax:

andromeda config <SUBCOMMAND>

Subcommands:

config init

Initialize a new configuration file with default values.

Syntax:

andromeda config init [OPTIONS]

Options:

• --format <FORMAT> - Configuration file format (json, toml, yaml) [default: json]
• -o, --output <PATH> - Output path for configuration file
• -f, --force - Force overwrite existing configuration file

Examples:

# Create default JSON config
andromeda config init

# Create TOML config
andromeda config init --format toml

# Create config in custom location
andromeda config init --output ./config/andromeda.json

# Force overwrite existing config
andromeda config init --force

config show

Display the current active configuration.

Syntax:

andromeda config show [OPTIONS]

Options:

• -f, --file <PATH> - Show configuration from specific file

Examples:

# Show current active config
andromeda config show

# Show specific config file
andromeda config show --file ./custom-config.toml

config validate

Validate configuration file format and values.

Syntax:

andromeda config validate [OPTIONS]

Options:

• -f, --file <PATH> - Config file to validate

Examples:

# Validate current config
andromeda config validate

# Validate specific file
andromeda config validate --file ./andromeda.json

Configuration Files:

Andromeda supports configuration in JSON, TOML, and YAML formats:

• andromeda.json - JSON configuration
• andromeda.toml - TOML configuration
• andromeda.yaml / andromeda.yml - YAML configuration

For detailed configuration options, see the Configuration Guide.

completions

Generate shell completion scripts for bash, zsh, fish, or PowerShell.

Syntax:

andromeda completions [SHELL]

Arguments:

• [SHELL] - Target shell (optional, auto-detects if not specified)
  • bash - Bash completion
  • zsh - Zsh completion
  • fish - Fish completion
  • powershell - PowerShell completion

Examples:

# Auto-detect shell and generate completions
andromeda completions

# Generate bash completions
andromeda completions bash > ~/.local/share/bash-completion/completions/andromeda

# Generate zsh completions
andromeda completions zsh > ~/.oh-my-zsh/completions/_andromeda

# Generate fish completions
andromeda completions fish > ~/.config/fish/completions/andromeda.fish

# Generate PowerShell completions
andromeda completions powershell > andromeda.ps1

upgrade

Upgrade Andromeda to the latest version or a specific version.

Syntax:

andromeda upgrade [OPTIONS]

Options:

• -f, --force - Force upgrade even if already on the latest version
• -v, --version <VERSION> - Upgrade to a specific version instead of latest
• --dry-run - Show what would be upgraded without actually upgrading

Examples:

# Upgrade to latest version
andromeda upgrade

# Force reinstall current version
andromeda upgrade --force

# Upgrade to specific version
andromeda upgrade --version v0.2.0

# Check what would be upgraded (dry run)
andromeda upgrade --dry-run

lsp

Start the Language Server Protocol (LSP) server for editor integration.

Syntax:

andromeda lsp

Description:

The LSP server provides real-time diagnostics and code analysis for JavaScript and TypeScript files in your editor. It offers comprehensive linting with built-in rules for code quality.

Features:

• Real-time Diagnostics - Live error reporting as you type
• Comprehensive Linting - 5 built-in rules for code quality:
  • Empty function detection
  • Empty statement detection
  • Variable usage validation
  • Unreachable code detection
  • Invalid syntax highlighting
• Multi-file Support - Workspace-wide analysis
• Rich Error Messages - Detailed explanations with code context
• Editor Integration - Works with VS Code, Neovim, and other LSP-compatible editors

Examples:

# Start the Language Server (typically called by your editor)
andromeda lsp

Editor Setup:

Configure your editor to use andromeda lsp as the language server for JavaScript and TypeScript files to get instant feedback on code quality.

lint

Analyze code for potential issues and style violations.

Syntax:

andromeda lint [PATHS...]

Arguments:

• [PATHS...] - Files or directories to lint (optional, defaults to current directory)

Examples:

# Lint specific files
andromeda lint script.ts utils.js

# Lint entire directory
andromeda lint src/

# Lint current directory
andromeda lint

# Lint multiple directories
andromeda lint src/ tests/ examples/

Lint Rules:

• Empty function detection
• Empty statement detection
• Variable usage validation
• Unreachable code detection
• Invalid syntax highlighting

bundle

Bundle JavaScript/TypeScript files and their dependencies into a single file.

Syntax:

andromeda bundle <INPUT> <OUTPUT>

Arguments:

• <INPUT> - Path to the entry file to bundle
• <OUTPUT> - Path for the output bundled file

Examples:

# Bundle a TypeScript application
andromeda bundle src/main.ts dist/app.js

# Bundle with dependencies
andromeda bundle index.ts bundle.js

# Bundle for distribution
andromeda bundle app.ts dist/standalone.js

Features:

• Module Resolution - Automatic dependency resolution
• Tree Shaking - Dead code elimination
• TypeScript Support - Seamless TS to JS bundling
• Single File Output - Self-contained bundles

Troubleshooting

For common issues and solutions, see the Troubleshooting Guide.

For more examples check out the Examples