# Aiui Cloud Integration

> Integrate server-side AIUI agents with Rokid account lookup, one-time message caching, and Rokid Glasses notifications through @yodaos-pkg/cloud-integration or HTTP. Invoke for AIUI cloud credentials, cached messages, notification delivery, or notification-triggered page navigation.

- Skill: `jsar-project/aiui-cloud-integration` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add jsar-project/aiui-cloud-integration`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jsar-project/aiui-cloud-integration/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: jsar-project (https://skillmd.com/u/jsar-project)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/jsar-project/aiui-cloud-integration

---


# AIUI Cloud Integration

Use this skill for server-side AIUI cloud integrations. Choose the relevant
reference instead of loading every API contract:

- For the system-agent-only account token endpoint, read
  [references/account-services.md](references/account-services.md).
- For temporarily storing a message for an agent to consume once, read
  [references/messaging.md](references/messaging.md).
- For Rokid Glasses notification delivery and notification-triggered page
  navigation, read [references/notifications.md](references/notifications.md).

## Package

Install the zero-runtime-dependency package:

```bash
npm install @yodaos-pkg/cloud-integration
```

Import `CloudIntegration` from the package and construct it with the Rokid
account SK. Keep the token in an environment variable or secret manager; do
not put it in AIUI page code, source control, logs, or user-visible data.

```js
import { CloudIntegration } from '@yodaos-pkg/cloud-integration'

const cloud = new CloudIntegration({
  token: process.env.ROKID_SK,
})

await cloud.sendNotification({
  messageId: 'message-unique-id',
  accountId: 'target-account-id',
  message: {
    agentId: 'agent-id',
    content: 'Notification text shown on the Glasses.',
  },
})
```

When Node.js is not appropriate, use the complete `curl` examples in the
relevant reference. Preserve the documented endpoint, authentication header,
and JSON field naming; the SDK uses camelCase while some HTTP APIs use
snake_case.

The account `accessToken` and notification `token` (Rokid account SK) are
different credentials. Keep both server-side in environment variables or a
secret manager. Never copy either into page code, client bundles, source
control, logs, or user-visible errors.

For package signatures and current implementation details, read
[`packages/cloud-integration/README.md`](../../packages/cloud-integration/README.md)
when working in this repository.