> ## Documentation Index
> Fetch the complete documentation index at: https://learn.nexudus.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Nexudus CLI & Skills

> An overview of the Nexudus command-line interface and AI Agent Skills for managing coworking spaces from your terminal or AI assistant.

# Nexudus CLI & Agent Skills

The **Nexudus CLI** is a command-line tool that lets you manage your Nexudus coworking spaces directly from your terminal. Combined with **Agent Skills**, it also enables AI assistants like GitHub Copilot and Claude to perform Nexudus operations on your behalf.

<Note>
  The Nexudus CLI and Agent Skills are under active development. New entity types, commands, and improvements are released regularly. Check the
  [GitHub repository](https://github.com/Nexudus-Ltd/nexudus-coworking-skills) for the latest updates.
</Note>

## What can you do with it?

<CardGroup cols={2}>
  <Card title="Manage from the terminal" icon="terminal">
    List, create, update, and delete entities like businesses, products, resources, bookings, coworkers, and many more — all from the command line.
  </Card>

  <Card title="AI-powered workflows" icon="robot">
    Install the Agent Skill so GitHub Copilot or Claude can manage your Nexudus data using natural language instructions.
  </Card>

  <Card title="Scriptable output" icon="code">
    Choose between human-friendly tables, raw JSON, Markdown, or a structured agent envelope — ideal for automation and scripting.
  </Card>

  <Card title="Secure authentication" icon="lock">
    Credentials are stored in your operating system's native secure storage (Windows Credential Manager, macOS Keychain, or Linux libsecret).
  </Card>
</CardGroup>

## Who is this for?

| Audience                | Use case                                                                                                        |
| ----------------------- | --------------------------------------------------------------------------------------------------------------- |
| **Coworking operators** | Automate repetitive management tasks, bulk-update entities, and query data without leaving the terminal.        |
| **Developers**          | Script against the Nexudus API, integrate with CI/CD pipelines, and build custom workflows.                     |
| **AI assistant users**  | Let GitHub Copilot or Claude manage your Nexudus spaces through natural language by installing the Agent Skill. |

## How it works

The CLI communicates with the [Nexudus REST API](/rest-api/overview) using the same endpoints available to all integrations. Every entity in Nexudus (businesses, products, resources, bookings, coworkers, etc.) follows a consistent CRUD pattern, and the CLI wraps each one into a simple command structure:

```
nexudus <entity> <action> [options] [--json | --md | --agent]
```

For example:

```bash theme={null}
# List all businesses
nexudus businesses list

# Get a specific product as JSON
nexudus products get 12345678 --json

# Create a new resource
nexudus resources create --name "Meeting Room A" --business 98765432
```

When used with the `--agent` flag, every command returns a structured JSON envelope that AI assistants can parse and act on automatically.

## Privacy & telemetry

The Nexudus CLI collects anonymous usage data to help us improve the tool. **Telemetry is enabled by default but can be disabled with a single command:**

```bash theme={null}
nexudus config set telemetry off
```

No sensitive data (credentials, API responses, or business information) is collected. Learn more about what data is collected, where it's sent, and how to disable telemetry in the [Telemetry](/cli/telemetry) documentation.

## Next steps

<CardGroup cols={2}>
  <Card title="Install the CLI" icon="download" href="/cli/installation">
    Download and set up the Nexudus CLI on your machine.
  </Card>

  <Card title="Install Agent Skills" icon="robot" href="/cli/agent-skills-installation">
    Enable GitHub Copilot or Claude to use the Nexudus CLI.
  </Card>
</CardGroup>