Skip to main content

​
Troubleshooting

​
CLI issues

​
nexudus command not found

The CLI is installed as a .NET global tool. Make sure:
  1. You have the .NET SDK installed (version 8 or later).
  2. You ran dotnet tool install --global Nexudus.Cli.
  3. The .NET tools directory is in your system PATH:
    • Windows: %USERPROFILE%\.dotnet\tools
    • macOS/Linux: ~/.dotnet/tools

​
API connection failures

If nexudus doctor reports that the API is unreachable:
  • Check your internet connection.
  • Verify the base URL is correct: nexudus config get base-url (default: https://spaces.nexudus.com).
  • Check whether a proxy or firewall is blocking outbound HTTPS connections.

​
Credential storage errors on Linux

The CLI uses libsecret for credential storage on Linux. If you get errors: 
# Install libsecret (Ubuntu/Debian)
sudo apt-get install libsecret-1-0 libsecret-1-dev

# Install libsecret (Fedora/RHEL)
sudo dnf install libsecret libsecret-devel
Make sure a keyring service (GNOME Keyring or KDE Wallet) is running.

​
Commands return empty results

  • Confirm you are authenticated: nexudus whoami.
  • Check that your account has permissions for the entity type you’re querying.
  • Try broadening your search: remove --query filters or increase --size.

​
Agent Skill issues

​
AI assistant doesn’t recognise the Nexudus skill

  1. Verify the skill is installed: npx skills list should show nexudus.
  2. Restart your editor or AI assistant session — skills are loaded at startup.
  3. If using VS Code with GitHub Copilot, try reloading the window (Ctrl+Shift+P → “Reload Window”).

​
AI assistant returns “Not logged in” errors

The AI assistant calls the CLI, which needs active credentials: 
nexudus login
After logging in, retry your request.

​
AI assistant constructs incorrect commands

The skill file may be outdated. Update to the latest version: 
npx skills add Nexudus-Ltd/nexudus-coworking-skills
You can also ask your assistant to run nexudus <entity> <command> --help to discover the correct options.

​
Pagination issues

By default, list commands return 25 results per page. If you’re not seeing all your data:
  • Ask for a larger page: “List all products with page size 100”
  • Or paginate: “Show page 2 of products”

​
Getting help