The sky skyline commands manage your project’s messaging configuration — profile, users, phone lines, platform toggles, and avatar.
All Skyline commands require an active project. Set INTERACTIONS_PROJECT_ID or pass --project <id>.
Skyline profile
sky skyline profile show
sky skyline profile update --display-name "Hackathon Bot"
Users
Manage users that interact through your project’s shared iMessage pool.
List users
sky skyline users ls
sky skyline users ls --json
Add a user
Register a recipient before messaging them on a shared line:
sky skyline users add --phone +15551234567
sky skyline users add --phone +15551234567 --email team@example.com
sky skyline users create.
Free plan: maximum 10 users per project. Removing a user frees a slot.
Remove a user
sky skyline users remove <user-id>
sky skyline users remove <user-id> -y
-y.
Aliases: sky skyline users rm, sky skyline users delete.
Lines
sky skyline lines ls
sky skyline lines add --platform imessage --resource <resource-id>
sky skyline lines remove <line-id>
sky skyline platforms ls
sky skyline platforms enable imessage
sky skyline platforms disable imessage
Avatar
sky skyline avatar upload photo.png
| Flag | Description |
|---|
--no-update-profile | Upload the file but don’t update the Skyline profile |
Hackathon workflow
Typical flow for a hackathon team:
export INTERACTIONS_PROJECT_ID=<team-project-id>
export INTERACTIONS_API_HOST=https://api.interactions.co.in
# Enable iMessage
sky skyline platforms enable imessage
# Register test recipients (up to 10)
sky skyline users add --phone +15551234567
sky skyline users ls
# Run your agent
export SKYLINE_PROJECT_ID=$INTERACTIONS_PROJECT_ID
export SKYLINE_PROJECT_SECRET=<secret-from-organizer>
bun run agent.ts
