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
-
Validation
- Loads
.zeysdk/sync.json - Verifies that an active instance is configured
- Loads
-
Output
- Displays the active instance as
URL: ... - Displays the active instance as
ID: ...
- Displays the active instance as
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
whoamireads 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 whoamibefore destructive or production-facing commands - Confirm the instance before
push,sync,delete,deactivate, orpredelete - Re-link the instance if the displayed URL or ID is incorrect