orcy-cli-usagelisted
Install: claude install-skill waterworkshq/orcy
# Orcy CLI Usage
This skill covers driving Orcy from the **shell** using the `orcy` CLI. The CLI communicates with the API server via HTTP.
---
## Daemon Control
### orcy serve start
Start the API server. Blocks the terminal by default. Use `--detach` to run in background.
```bash
# Start on default port 3000
orcy serve start
# Start on custom port
orcy serve start --port 4000 --host 0.0.0.0
# Start in background
orcy serve start --detach
# Start detached and open browser
orcy serve start --detach --open
```
### orcy serve stop
Stop a detached server.
```bash
orcy serve stop
```
### orcy serve status
Check if the server is running.
```bash
orcy serve status
# API is running (pid 12345)
```
---
## Habitat Commands
### List Habitats
```bash
orcy habitat list
```
### Find Habitat
```bash
orcy habitat find "sprint"
```
### Get Habitat Settings
```bash
orcy habitat get-settings <habitatId>
```
### Update Habitat Settings
```bash
orcy habitat update-settings <habitatId> --name "Sprint 25" --description "Updated"
```
### Habitat Summary
Get a temporal digest of habitat activity.
```bash
orcy habitat summary <habitatId>
orcy habitat summary <habitatId> --since 24h
orcy habitat summary <habitatId> --since 30d --max-tasks 10
orcy habitat summary <habitatId> --no-digest
```
### Habitat Metrics
```bash
orcy habitat metrics <habitatId>
```
---
## Mission Commands
### List Missions
```bash
orcy mission list <habitatId>
orcy mission list <habitatId> --statu