---
title: "Show Current Instance"
description: "Documentation for Show Current Instance Command in ZeyOS SDK CLI"
canonical_url: "https://www.zeyos.com/sdk/platform-management/zeysdk-whoami"
markdown_url: "https://www.zeyos.com/ai/guide/sdk/platform-management/zeysdk-whoami.md"
section: "sdk"
authority: "guide"
language: "en"
source_repository: "zeyos/sdk-v2"
source_path: "docs/platform-management/zeysdk-whoami.md"
source_revision: "a99897af74253b4dc5af6fecb9301cea0ae18e27"
---

# Show Current Instance

The `whoami` command displays the active ZeyOS instance for the current application.

```bash
zeysdk whoami [options]
```

**Options**

| Option | Description |
|--------|-------------|
| `--verbose` | Show detailed output |

**Process**

1. **Validation**
   - Loads `.zeysdk/sync.json`
   - Verifies that an active instance is configured

2. **Output**
   - Displays the active instance as `URL: ...`
   - Displays the active instance as `ID: ...`


**Examples**

```bash
zeysdk whoami
zeysdk whoami --verbose
```

**Error Handling**

| Error | Description | Resolution |
|-------|-------------|------------|
| Missing sync.json | No active instance configuration | Run `zeysdk link` |
| Invalid sync.json | Active instance configuration is invalid | Re-link the instance |

**Notes**

- `whoami` reads the active instance from `.zeysdk/sync.json`
- It does not validate credentials or contact the remote instance
- The command is useful before operations that modify remote state
- Use verbose output when troubleshooting local sync configuration

**Best Practices**

- Run `zeysdk whoami` before destructive or production-facing commands
- Confirm the instance before `push`, `sync`, `delete`, `deactivate`, or `predelete`
- Re-link the instance if the displayed URL or ID is incorrect