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

Menu Navigation Issues

• 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.