Page cover

CLI Troubleshooting

This guide provides solutions for common issues you might encounter when using the JuliaOS CLI.

CLI Can't Connect to Server

  • Ensure the Julia server is running:

    curl http://localhost:8052/health
  • Check if the CLI is using the correct server URL:

    export JULIA_SERVER_URL=http://localhost:8052
    node scripts/interactive.cjs
  • Try using the mock server instead:

    node scripts/mock_server.js
    # In another terminal
    node scripts/interactive.cjs
  • Ensure your terminal supports ANSI escape sequences.

  • Try running in a different terminal emulator.

  • Set the FORCE_COLOR environment variable:

    export FORCE_COLOR=1
    node scripts/interactive.cjs

Command Not Found

  • Ensure you're running the CLI from the project root directory:

    cd /path/to/JuliaOS
    node scripts/interactive.cjs
  • Check if the command exists in the CLI:

    node scripts/interactive.cjs help
  • Try running the command through the interactive menu instead.

General Tips

  • Always start the Julia server before the CLI.

  • Use the latest versions of Node.js and Julia.

  • Check logs and error messages for more details.

For more troubleshooting tips, see the full Troubleshooting Guide.