# Inbox Monitoring

> Use this skill when the user wants to monitor Aicoo inbox activity, check new conversations/messages, track pending requests, or run periodic inbox checks. Triggers on: 'inbox monitoring', 'monitor inbox', 'new messages', 'pending requests', 'message watch', '收件箱监控', '/v1/conversations', '/v1/network/requests'.

- **Type:** Skill
- **Install:** `agentstack add skill-aicoo-team-aicoo-skills-inbox-monitoring`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Aicoo-Team](https://agentstack.voostack.com/s/aicoo-team)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Aicoo-Team](https://github.com/Aicoo-Team)
- **Source:** https://github.com/Aicoo-Team/AICOO-Skills/tree/main/skills/inbox-monitoring
- **Website:** https://aicoo.io/docs

## Install

```sh
agentstack add skill-aicoo-team-aicoo-skills-inbox-monitoring
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Inbox Monitoring

Monitor incoming communication in Aicoo and surface what needs action.

## Prerequisites

- `AICOO_API_KEY` must be set
- Base URL: `https://www.aicoo.io/api/v1`

## Endpoints

- `GET /api/v1/conversations?view=all&limit=...`
- `GET /api/v1/network/requests`
- `GET /api/v1/os/network` (optional context: links/visitors/contacts)

## Core Workflow

### Step 1: Pull conversation inbox

```bash
curl -s "https://www.aicoo.io/api/v1/conversations?view=all&limit=50" \
  -H "Authorization: Bearer $AICOO_API_KEY" | jq .
```

Views:

- `view=me` for direct/human
- `view=coo` for shared-agent conversations
- `view=all` for combined monitor

### Step 2: Pull pending requests

```bash
curl -s "https://www.aicoo.io/api/v1/network/requests" \
  -H "Authorization: Bearer $AICOO_API_KEY" | jq .
```

### Step 3: Optional network context

```bash
curl -s "https://www.aicoo.io/api/v1/os/network" \
  -H "Authorization: Bearer $AICOO_API_KEY" | jq .
```

### Step 4: Build action queue

Prioritize in this order:

1. New inbound agent/human messages requiring response
2. Incoming pending requests (`type: agent` first, then `type: friend`)
3. High-signal visitor or share-link activity

## Claude Code Automation

Use `/loop` or `/routine`.

### `/loop` example

```
/loop 15m monitor my Aicoo inbox using /v1/conversations?view=all and /v1/network/requests; report only new items since last check and recommended replies.
```

### `/routine` example

```
/routine inbox-monitor every 15 minutes: check /v1/conversations + /v1/network/requests and summarize urgent items only.
```

## OpenClaw Automation (CRON)

Use the provided script:

```bash
# Every 15 minutes
*/15 * * * * /path/to/aicoo-skills/scripts/inbox-monitor-cron.sh >> /tmp/aicoo-inbox-monitor.log 2>&1
```

Optional envs:

- `PULSE_INBOX_VIEW` (`all` | `me` | `coo`, default: `all`)
- `PULSE_INBOX_LIMIT` (default: `50`)
- `PULSE_INBOX_STATE_FILE` (default: `/tmp/pulse-inbox-monitor-state.json`)

## Output Contract

For each run, return:

1. `newMessages` count
2. `newIncomingRequests` count
3. top urgent items (contact + timestamp + one-line summary)
4. suggested next actions (reply / accept / ignore)

If no new items, return a single line: `No new inbox activity since last check.`

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Aicoo-Team](https://github.com/Aicoo-Team)
- **Source:** [Aicoo-Team/AICOO-Skills](https://github.com/Aicoo-Team/AICOO-Skills)
- **License:** MIT
- **Homepage:** https://aicoo.io/docs

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-aicoo-team-aicoo-skills-inbox-monitoring
- Seller: https://agentstack.voostack.com/s/aicoo-team
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.