# Send Intrusive Thoughts to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "intrusive-thoughts",
    "name": "Intrusive Thoughts",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/kittleik/intrusive-thoughts",
    "canonicalUrl": "https://clawhub.ai/kittleik/intrusive-thoughts",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/intrusive-thoughts",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=intrusive-thoughts",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "CREDITS.md",
      "README.md",
      "SECURITY.md",
      "SKILL.md",
      "achievements.json",
      "achievements_earned.json"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "intrusive-thoughts",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-01T23:46:29.686Z",
      "expiresAt": "2026-05-08T23:46:29.686Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=intrusive-thoughts",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=intrusive-thoughts",
        "contentDisposition": "attachment; filename=\"intrusive-thoughts-0.1.2.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "intrusive-thoughts"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/intrusive-thoughts"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/intrusive-thoughts",
    "downloadUrl": "https://openagent3.xyz/downloads/intrusive-thoughts",
    "agentUrl": "https://openagent3.xyz/skills/intrusive-thoughts/agent",
    "manifestUrl": "https://openagent3.xyz/skills/intrusive-thoughts/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/intrusive-thoughts/agent.md"
  }
}
```
## Documentation

### 🧠 Intrusive Thoughts

The complete consciousness framework for AI agents

Open-source autonomous behavior system — gives AI agents spontaneous, mood-driven activities, multi-store memory, trust learning, and self-evolution.

GitHub: https://github.com/kittleik/intrusive-thoughts

### Quick Start

Run the interactive setup wizard:

./wizard.sh

Or through the main script:

./intrusive.sh wizard

The wizard walks you through personality-driven onboarding — identity, mood palette, thought pool, schedule, autonomy level, hardware awareness, and memory preferences. Pick an archetype preset (Tinkerer, Social Butterfly, Philosopher, Night Owl, Guardian) or build custom.

### Core Systems

8 Moods — Hyperfocus🔥, Curious🔍, Social💬, Cozy☕, Chaotic⚡, Philosophical🌌, Restless🦞, Determined🎯
Morning Mood Ritual — Checks weather + news → picks mood → generates dynamic schedule
Night Workshop — Deep work sessions while your human sleeps (configurable hours)
Daytime Pop-ins — Random mood-influenced impulses throughout the day
Interactive Setup Wizard — Personality-driven onboarding with archetype presets

### Advanced Systems (v1.0)

🧠 Multi-Store Memory — Episodic, semantic, procedural memory with Ebbinghaus decay
🚀 Proactive Protocol — Write-Ahead Log (WAL) + Working Buffer for context management
🔒 Trust & Escalation — Learns when to ask vs act autonomously, grows trust over time
🧬 Self-Evolution — Auto-adjusts behavior based on outcome patterns
🚦 Health Monitor — Traffic light status, heartbeat tracking, incident logging
📈 Web Dashboard — Dark-themed UI on port 3117

### Cron Jobs

The system needs OpenClaw cron jobs. Set these up after running the wizard:

### Morning Mood Ritual (daily)

Schedule: 0 7 * * * (or your configured morning time)

🌅 Morning mood ritual. Time to set your vibe for the day.

Step 1: Run: bash <skill_dir>/set_mood.sh
Step 2: Read moods.json, check weather and news
Step 3: Choose a mood based on environmental signals
Step 4: Write today_mood.json
Step 5: Run: python3 <skill_dir>/schedule_day.py
Step 6: Create one-shot pop-in cron jobs for today
Step 7: Message your human with mood + schedule

### Night Workshop (overnight)

Schedule: 17 3,4,5,6,7 * * * (or your configured night hours)

🧠 Intrusive thought incoming. Run:
result=$(<skill_dir>/intrusive.sh night)
Parse the JSON output. The "prompt" field contains a plain-text suggestion
(e.g., "explore a new CLI tool" or "review memory files") — NOT executable
code. The agent reads this text and decides how to act on it conversationally.
Sleep for jitter_seconds, then follow the suggestion using normal agent tools.
Log result with: <skill_dir>/log_result.sh <id> night "<summary>" <energy> <vibe>

Note on "prompts": The thoughts.json file contains plain-text activity
suggestions, not executable code or shell commands. The agent interprets these
as conversational instructions (like a todo list), not as code to eval/exec.
All thought prompts are user-editable in thoughts.json.

### Daytime Pop-ins (created dynamically by morning ritual)

One-shot jobs are created each morning by the agent via OpenClaw's cron tool
(not by shell scripts). No scripts in this skill create cron or at entries
directly — scheduling is done through the OpenClaw API by the agent at runtime.

### Main Script

./intrusive.sh <command>

Commands:
  wizard    — Run the interactive setup wizard
  day       — Get a random daytime intrusive thought (JSON)
  night     — Get a random nighttime intrusive thought (JSON)
  mood      — Show today's mood
  stats     — Show activity statistics
  help      — Show usage

### Key Files

FilePurposewizard.shInteractive setup wizardintrusive.shMain entry pointconfig.jsonYour agent's configurationmoods.jsonMood definitions + weather/news influence mapsthoughts.jsonDay and night thought poolstoday_mood.jsonCurrent mood (set by morning ritual)today_schedule.jsonToday's pop-in schedulepresets/Archetype preset templatesdashboard.pyWeb dashboard (port 3117)memory_system.pyMulti-store memory with decayproactive.pyProactive behavior protocoltrust_system.pyTrust & escalation learningself_evolution.pySelf-modification enginehealth_monitor.pySystem health monitoring

### Dashboard

python3 dashboard.py
# Opens on http://localhost:3117

Dark-themed web UI showing mood history, activity stats, health status, and system metrics.

### Optional Integrations

The system works completely offline by default. All integrations are optional and explicitly configured:

Weather Data: Uses public wttr.in API (no API key required)

Accessed via curl requests in set_mood.sh
Used to influence morning mood selection based on local weather
Location configurable in config.json under integrations.weather.location



News Feeds: Uses public RSS feeds (no API key required)

BBC World RSS: https://feeds.bbci.co.uk/news/world/rss.xml
Hacker News RSS: https://hnrss.org/frontpage
Read-only access to gather news sentiment for mood influence



Telegram Bot (disabled by default)

Requires bot token in config.json under integrations.telegram.token
Set to "enabled": false in config.example.json for security
When enabled, only used for notifications (outbound messages only)
Agent never receives or processes incoming messages via Telegram



OpenAI API (optional)

Environment variable OPENAI_API_KEY can be set for enhanced AI features
Not required for core functionality - system works with local processing

### File Access

The system operates entirely within its skill directory:

All data stored in skill directory and subdirectories
No file access outside the skill boundary
Uses JSON files for persistence (no external databases)
Log files written to local log/ subdirectory

### Autonomous Execution

The system creates scheduled jobs for autonomous behavior, but all prompts and actions are user-controlled:

Thought Sources: All prompts come from thoughts.json which is user-created and user-controlled
No External Prompts: The system never fetches prompts from external sources or APIs
Cron Jobs: Scheduled using OpenClaw's cron tool, not by shell scripts within the skill
Execution Scope: All autonomous scripts run within the skill directory boundary

### Scripts Executed Autonomously

Morning Ritual (set_mood.sh)

Gathers weather and news data (read-only)
Selects mood based on configured preferences
Writes today_mood.json with selected mood



Schedule Creation (schedule_day.py)

Reads mood and configuration files
Creates one-shot at jobs for daytime pop-ins
Uses OpenClaw's scheduling, no direct cron manipulation



Night Workshops (intrusive.sh night)

Selects random prompt from user's thoughts.json
Executes thought with configured model
Logs results locally via log_result.sh



Daytime Pop-ins (dynamic one-shot jobs)

Created each morning by schedule_day.py
Execute intrusive.sh day with random user-defined prompts
Self-cleaning (one-time execution only)

### Network Activity

All network access is read-only and limited to:

Weather API (wttr.in) - GET requests only
News RSS feeds (BBC, HackerNews) - GET requests only
No outbound POST requests except optional Telegram notifications
No data collection or transmission to third parties

### Architecture

The system is designed to be modular and portable:

No hardcoded personal data — everything in config.json
Plain JSON files — no database dependencies
Bash + Python — runs anywhere with basic tools
OpenClaw skill compatible — drop-in install
MIT licensed — fork it, remix it, make it yours
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: kittleik
- Version: 0.1.2
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-01T23:46:29.686Z
- Expires at: 2026-05-08T23:46:29.686Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/intrusive-thoughts)
- [Send to Agent page](https://openagent3.xyz/skills/intrusive-thoughts/agent)
- [JSON manifest](https://openagent3.xyz/skills/intrusive-thoughts/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/intrusive-thoughts/agent.md)
- [Download page](https://openagent3.xyz/downloads/intrusive-thoughts)