npm install -g @lark-sh/cli

npx @lark-sh/cli <command>

lark login

lark config set-project my-project

# Create a new project
lark projects create "My Game"
# Created project: my-game

# Set it as default
lark config set-project my-game

# Create a database
lark db create game-state

# Write data
lark data set game-state /players/alice '{"name": "Alice", "score": 0}'

# Read it back
lark data get game-state /players/alice
# {"name": "Alice", "score": 0}

# Update a single field (shallow merge)
lark data update game-state /players/alice '{"score": 42}'

# Push to a list with an auto-generated key
lark data push game-state /messages '{"text": "Hello!", "sender": "alice"}'
# -Nabc123def

# Delete data
lark data delete game-state /players/alice

cat player-data.json | lark data set game-state /players -

echo '{"score": 99}' | lark data update game-state /players/alice -

lark data watch game-state /players

[put] {"path":"/","data":{"alice":{"name":"Alice","score":42}}}
[patch] {"path":"/alice/score","data":99}

# Export a database to a file
lark data export game-state -o backup.json

# Export a specific path
lark data export game-state /players -o players.json

# Import data from a file
lark data import game-state -f backup.json

# Import to a specific path
lark data import game-state /players -f players.json

# View current rules
lark rules get

# Set rules from a file (JSON5 supported)
lark rules set -f rules.json

# Or pipe them in
cat rules.json | lark rules set

# Show dashboard with current metrics
lark dashboard

# View recent events
lark events

# Check billing for a specific month
lark billing --period 2026-02

# Get project details as JSON
lark projects show --json

# List databases as JSON
lark db list --json

# Use with jq
lark data get game-state /players --json | jq '.alice.score'