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

# Commands & Settings

> All available commands and configuration settings for the ShardCloud VS Code extension.

## Commands

All commands are available via the Command Palette (`Ctrl+Shift+P` / `Cmd+Shift+P`).

<Info>
  You can also access most commands by right-clicking in the ShardCloud sidebar or using the context menu.
</Info>

***

### Authentication

| Command              | Description                      |
| -------------------- | -------------------------------- |
| `ShardCloud: Login`  | Authenticate with your API token |
| `ShardCloud: Logout` | Sign out of your account         |

***

### Application Management

| Command                            | Description                                |
| ---------------------------------- | ------------------------------------------ |
| `ShardCloud: Deploy`               | Deploy current workspace to the linked app |
| `ShardCloud: Deploy to App...`     | Deploy to any app (select from list)       |
| `ShardCloud: Start App`            | Start the linked application               |
| `ShardCloud: Stop App`             | Stop the linked application                |
| `ShardCloud: Restart App`          | Restart the linked application             |
| `ShardCloud: View Logs`            | Stream application logs in real-time       |
| `ShardCloud: Link to Existing App` | Link current workspace to an existing app  |

***

### Quick Actions

| Command                         | Description                                     |
| ------------------------------- | ----------------------------------------------- |
| `ShardCloud: Open in Dashboard` | Open the linked app in ShardCloud Dashboard     |
| `ShardCloud: Open Website`      | Open the app's website URL                      |
| `ShardCloud: Sync Config`       | Sync `.shardcloud` config from the deployed app |
| `ShardCloud: Refresh`           | Refresh the sidebar data                        |

***

## Extension Settings

Configure the extension in VS Code Settings (`Ctrl+,` / `Cmd+,`) or by editing your `settings.json` file.

### Available Settings

| Setting                          | Description                      | Default                      |
| -------------------------------- | -------------------------------- | ---------------------------- |
| `shardcloud.apiToken`            | Your ShardCloud API token        | -                            |
| `shardcloud.apiBaseUrl`          | API endpoint URL                 | `https://shardcloud.app/api` |
| `shardcloud.autoRefreshInterval` | Auto-refresh interval in seconds | `30`                         |
| `shardcloud.showStatusBar`       | Show ShardCloud status bar item  | `true`                       |

***

### Configuration Examples

#### settings.json

```json theme={null}
{
  "shardcloud.apiToken": "your-api-token-here",
  "shardcloud.autoRefreshInterval": 60,
  "shardcloud.showStatusBar": true
}
```

<Warning>
  Never commit your API token to version control. Use VS Code's secure storage or set the token via the Login command.
</Warning>

***

## Keyboard Shortcuts

You can assign custom keyboard shortcuts to any ShardCloud command:

1. Open Keyboard Shortcuts (`Ctrl+K Ctrl+S` / `Cmd+K Cmd+S`)
2. Search for "ShardCloud"
3. Click the plus icon to add a keybinding

### Suggested Shortcuts

| Command                   | Suggested Shortcut |
| ------------------------- | ------------------ |
| `ShardCloud: Deploy`      | `Ctrl+Shift+D`     |
| `ShardCloud: View Logs`   | `Ctrl+Shift+L`     |
| `ShardCloud: Restart App` | `Ctrl+Shift+R`     |

***

## Status Bar

When enabled, the status bar shows:

* **Connection status** - Whether you're logged in
* **Linked app name** - The currently linked application
* **Quick actions** - Click to access common commands

<Tip>
  Click the status bar item to quickly access deploy, logs, and restart actions.
</Tip>