agentpeeps 0.0.0-stage → 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.agents/plugins/marketplace.json +11 -0
- package/.claude-plugin/marketplace.json +12 -0
- package/.claude-plugin/plugin.json +9 -0
- package/.codex-plugin/plugin.json +39 -0
- package/LICENSE +21 -0
- package/README.md +251 -2
- package/avatars/free/capybaras/capybara-bee-animated.webp +0 -0
- package/avatars/free/capybaras/capybara-bee.webp +0 -0
- package/avatars/free/capybaras/capybara-duck-animated.webp +0 -0
- package/avatars/free/capybaras/capybara-duck.webp +0 -0
- package/avatars/free/capybaras/capybara-friends-animated.webp +0 -0
- package/avatars/free/capybaras/capybara-friends.webp +0 -0
- package/avatars/free/capybaras/capybara-glasses-animated.webp +0 -0
- package/avatars/free/capybaras/capybara-glasses.webp +0 -0
- package/avatars/free/capybaras/capybara-hair-rollers-animated.webp +0 -0
- package/avatars/free/capybaras/capybara-hair-rollers.webp +0 -0
- package/avatars/free/capybaras/capybara-harness-animated.webp +0 -0
- package/avatars/free/capybaras/capybara-harness.webp +0 -0
- package/avatars/free/capybaras/capybara-in-a-dress-animated.webp +0 -0
- package/avatars/free/capybaras/capybara-in-a-dress.webp +0 -0
- package/avatars/free/capybaras/capybara-rose-animated.webp +0 -0
- package/avatars/free/capybaras/capybara-rose.webp +0 -0
- package/avatars/free/cats/cat-big-eyes-animated.webp +0 -0
- package/avatars/free/cats/cat-big-eyes.webp +0 -0
- package/avatars/free/cats/cat-big-yawn-animated.webp +0 -0
- package/avatars/free/cats/cat-big-yawn.webp +0 -0
- package/avatars/free/cats/cat-curious-kitten-animated.webp +0 -0
- package/avatars/free/cats/cat-curious-kitten.webp +0 -0
- package/avatars/free/cats/cat-fluffy-round-animated.webp +0 -0
- package/avatars/free/cats/cat-fluffy-round.webp +0 -0
- package/avatars/free/cats/cat-french-fries-animated.webp +0 -0
- package/avatars/free/cats/cat-french-fries.webp +0 -0
- package/avatars/free/cats/cat-grumpy-animated.webp +0 -0
- package/avatars/free/cats/cat-grumpy.webp +0 -0
- package/avatars/free/cats/cat-in-a-banana-animated.webp +0 -0
- package/avatars/free/cats/cat-in-a-banana.webp +0 -0
- package/avatars/free/cats/cat-long-neck-animated.webp +0 -0
- package/avatars/free/cats/cat-long-neck.webp +0 -0
- package/avatars/free/cats/cat-lying-down-animated.webp +0 -0
- package/avatars/free/cats/cat-lying-down.webp +0 -0
- package/avatars/free/cats/cat-on-its-back-animated.webp +0 -0
- package/avatars/free/cats/cat-on-its-back.webp +0 -0
- package/avatars/free/cats/cat-open-mouth-animated.webp +0 -0
- package/avatars/free/cats/cat-open-mouth.webp +0 -0
- package/avatars/free/cats/cat-orange-costume-animated.webp +0 -0
- package/avatars/free/cats/cat-orange-costume.webp +0 -0
- package/avatars/free/cats/cat-orange-kitten-animated.webp +0 -0
- package/avatars/free/cats/cat-orange-kitten.webp +0 -0
- package/avatars/free/cats/cat-pizza-animated.webp +0 -0
- package/avatars/free/cats/cat-pizza.webp +0 -0
- package/avatars/free/cats/cat-pointy-ears-animated.webp +0 -0
- package/avatars/free/cats/cat-pointy-ears.webp +0 -0
- package/avatars/free/cats/cat-round-face-animated.webp +0 -0
- package/avatars/free/cats/cat-round-face.webp +0 -0
- package/avatars/free/cats/cat-round-profile-animated.webp +0 -0
- package/avatars/free/cats/cat-round-profile.webp +0 -0
- package/avatars/free/cats/cat-smirk-animated.webp +0 -0
- package/avatars/free/cats/cat-smirk.webp +0 -0
- package/avatars/free/cats/cat-squinting-animated.webp +0 -0
- package/avatars/free/cats/cat-squinting.webp +0 -0
- package/avatars/free/cats/cat-standing-kitten-animated.webp +0 -0
- package/avatars/free/cats/cat-standing-kitten.webp +0 -0
- package/avatars/free/cats/cat-standing-up-animated.webp +0 -0
- package/avatars/free/cats/cat-standing-up.webp +0 -0
- package/avatars/free/cats/cat-sunglasses-animated.webp +0 -0
- package/avatars/free/cats/cat-sunglasses.webp +0 -0
- package/avatars/free/cats/cat-tabby-animated.webp +0 -0
- package/avatars/free/cats/cat-tabby-pile-animated.webp +0 -0
- package/avatars/free/cats/cat-tabby-pile.webp +0 -0
- package/avatars/free/cats/cat-tabby-stare-animated.webp +0 -0
- package/avatars/free/cats/cat-tabby-stare.webp +0 -0
- package/avatars/free/cats/cat-tabby.webp +0 -0
- package/avatars/free/cats/cat-white-side-eye-animated.webp +0 -0
- package/avatars/free/cats/cat-white-side-eye.webp +0 -0
- package/avatars/free/color-blobs/blob-black-orb.webp +0 -0
- package/avatars/free/color-blobs/blob-blue-triangle.webp +0 -0
- package/avatars/free/color-blobs/blob-brown-clover.webp +0 -0
- package/avatars/free/color-blobs/blob-gray-pebble.webp +0 -0
- package/avatars/free/color-blobs/blob-green-capsule.webp +0 -0
- package/avatars/free/color-blobs/blob-orange-cloud.webp +0 -0
- package/avatars/free/costume-cats/banana-cat.webp +0 -0
- package/avatars/free/costume-cats/blanket-cat.webp +0 -0
- package/avatars/free/costume-cats/blueberry-cat.webp +0 -0
- package/avatars/free/costume-cats/fish-snack-cat.webp +0 -0
- package/avatars/free/costume-cats/frog-hood-cat.webp +0 -0
- package/avatars/free/costume-cats/headphone-cat.webp +0 -0
- package/avatars/free/costume-cats/shark-hood-cat.webp +0 -0
- package/avatars/free/critters/hamster-paws-animated.webp +0 -0
- package/avatars/free/critters/hamster-paws.webp +0 -0
- package/avatars/free/critters/pigeon-hop-animated.webp +0 -0
- package/avatars/free/critters/t-rex-guitar-animated.webp +0 -0
- package/avatars/free/critters/t-rex-guitar.webp +0 -0
- package/avatars/free/critters/teary-pink-blob.webp +0 -0
- package/avatars/free/flame-expressions/flame-angry.webp +0 -0
- package/avatars/free/flame-expressions/flame-confusion.webp +0 -0
- package/avatars/free/flame-expressions/flame-friendly.webp +0 -0
- package/avatars/free/flame-expressions/flame-gusto.webp +0 -0
- package/avatars/free/flame-expressions/flame-joy.webp +0 -0
- package/avatars/free/flame-expressions/flame-sly.webp +0 -0
- package/avatars/free/flame-expressions/flame-upset.webp +0 -0
- package/avatars/free/flame-expressions/flame-walk.webp +0 -0
- package/avatars/free/flame-expressions/flame-watching.webp +0 -0
- package/avatars/free/fruit-cats/cherry-cat.webp +0 -0
- package/avatars/free/fruit-cats/kiwi-cat.webp +0 -0
- package/avatars/free/fruit-cats/orange-cat.webp +0 -0
- package/avatars/free/fruit-cats/pineapple-cat.webp +0 -0
- package/avatars/free/fruit-cats/strawberry-cat.webp +0 -0
- package/avatars/free/fruit-cats/watermelon-cat.webp +0 -0
- package/avatars/free/gradient-icons/gradient-cat-skull.webp +0 -0
- package/avatars/free/gradient-icons/gradient-chef.webp +0 -0
- package/avatars/free/gradient-icons/gradient-eyed-shadow.webp +0 -0
- package/avatars/free/gradient-icons/gradient-flame.webp +0 -0
- package/avatars/free/gradient-icons/gradient-rabbit-shadow.webp +0 -0
- package/avatars/free/gradient-icons/gradient-sleepy-ghost.webp +0 -0
- package/avatars/free/manga-faces/manga-bangs-smile.webp +0 -0
- package/avatars/free/manga-faces/manga-bob-side-eye.webp +0 -0
- package/avatars/free/manga-faces/manga-closed-eyes-frown.webp +0 -0
- package/avatars/free/manga-faces/manga-glasses-headset.webp +0 -0
- package/avatars/free/manga-faces/manga-glasses-wink.webp +0 -0
- package/avatars/free/manga-faces/manga-short-hair-smile.webp +0 -0
- package/avatars/free/manga-faces/manga-side-part-wink.webp +0 -0
- package/avatars/free/manga-faces/manga-side-swept-smile.webp +0 -0
- package/avatars/free/manga-faces/manga-tousled-grin.webp +0 -0
- package/avatars/free/monster-icons/monster-amber-chick.webp +0 -0
- package/avatars/free/monster-icons/monster-aqua-frog.webp +0 -0
- package/avatars/free/monster-icons/monster-coral-alien.webp +0 -0
- package/avatars/free/monster-icons/monster-indigo-boar.webp +0 -0
- package/avatars/free/monster-icons/monster-lavender-bunny.webp +0 -0
- package/avatars/free/monster-icons/monster-navy-cyclops.webp +0 -0
- package/avatars/free/monster-icons/monster-orange-fish.webp +0 -0
- package/avatars/free/monster-icons/monster-pink-sleepy-cat.webp +0 -0
- package/avatars/free/monster-icons/monster-purple-octopus.webp +0 -0
- package/avatars/free/monster-icons/monster-red-stalk-eyes.webp +0 -0
- package/avatars/free/monster-icons/monster-rose-bat.webp +0 -0
- package/avatars/free/monster-icons/monster-teal-crocodile.webp +0 -0
- package/avatars/free/pixel-food/pixel-astronaut.webp +0 -0
- package/avatars/free/pixel-food/pixel-block-sprout.webp +0 -0
- package/avatars/free/pixel-food/pixel-blue-hair.webp +0 -0
- package/avatars/free/pixel-food/pixel-blue-horned.webp +0 -0
- package/avatars/free/pixel-food/pixel-cat-glasses.webp +0 -0
- package/avatars/free/pixel-food/pixel-cone-hat.webp +0 -0
- package/avatars/free/pixel-food/pixel-maroon-creature.webp +0 -0
- package/avatars/free/pixel-food/pixel-orange-creature.webp +0 -0
- package/avatars/free/pixel-food/pixel-orange-sprout.webp +0 -0
- package/avatars/free/pixel-food/pixel-red-hood.webp +0 -0
- package/avatars/free/pixel-food/pixel-watermelon.webp +0 -0
- package/avatars/free/pixel-food/pixel-white-bunny.webp +0 -0
- package/avatars/free/plush-blobs/plush-blue-alarmed.webp +0 -0
- package/avatars/free/plush-blobs/plush-green-surprised.webp +0 -0
- package/avatars/free/plush-blobs/plush-pink-smile.webp +0 -0
- package/avatars/free/plush-blobs/plush-red-angry.webp +0 -0
- package/avatars/free/plush-blobs/plush-yellow-frustrated.webp +0 -0
- package/avatars/free/retro-windows/retro-arrow-cursor.webp +0 -0
- package/avatars/free/retro-windows/retro-blank-window.webp +0 -0
- package/avatars/free/retro-windows/retro-cyan-notepad.webp +0 -0
- package/avatars/free/retro-windows/retro-desktop-computer.webp +0 -0
- package/avatars/free/retro-windows/retro-dialog-stack.webp +0 -0
- package/avatars/free/retro-windows/retro-eye-warning.webp +0 -0
- package/avatars/free/retro-windows/retro-gear-document.webp +0 -0
- package/avatars/free/retro-windows/retro-hand-cursor.webp +0 -0
- package/avatars/free/retro-windows/retro-heart-pet.webp +0 -0
- package/avatars/free/retro-windows/retro-music-cd.webp +0 -0
- package/avatars/free/retro-windows/retro-paint-palette.webp +0 -0
- package/avatars/free/retro-windows/retro-pen-notepad.webp +0 -0
- package/avatars/free/retro-windows/retro-pixel-tree.webp +0 -0
- package/avatars/free/retro-windows/retro-recycle-bin.webp +0 -0
- package/avatars/free/retro-windows/retro-warning-triangle.webp +0 -0
- package/avatars/free/retro-windows/retro-yellow-folder.webp +0 -0
- package/avatars/free/seals-and-sea-lions/otter-tongue-out-animated.webp +0 -0
- package/avatars/free/seals-and-sea-lions/otter-tongue-out.webp +0 -0
- package/avatars/free/seals-and-sea-lions/sea-lion-curious-face-animated.webp +0 -0
- package/avatars/free/seals-and-sea-lions/sea-lion-curious-face.webp +0 -0
- package/avatars/free/seals-and-sea-lions/sea-lion-gliding-animated.webp +0 -0
- package/avatars/free/seals-and-sea-lions/sea-lion-gliding.webp +0 -0
- package/avatars/free/seals-and-sea-lions/sea-lion-green-hood-animated.webp +0 -0
- package/avatars/free/seals-and-sea-lions/sea-lion-green-hood.webp +0 -0
- package/avatars/free/seals-and-sea-lions/sea-lion-mid-flip-animated.webp +0 -0
- package/avatars/free/seals-and-sea-lions/sea-lion-mid-flip.webp +0 -0
- package/avatars/free/seals-and-sea-lions/sea-lion-nose-boop-animated.webp +0 -0
- package/avatars/free/seals-and-sea-lions/sea-lion-nose-boop.webp +0 -0
- package/avatars/free/seals-and-sea-lions/sea-lion-on-a-rock-animated.webp +0 -0
- package/avatars/free/seals-and-sea-lions/sea-lion-on-a-rock.webp +0 -0
- package/avatars/free/seals-and-sea-lions/sea-lion-raised-flipper-animated.webp +0 -0
- package/avatars/free/seals-and-sea-lions/sea-lion-raised-flipper.webp +0 -0
- package/avatars/free/seals-and-sea-lions/sea-lion-sitting-profile-animated.webp +0 -0
- package/avatars/free/seals-and-sea-lions/sea-lion-sitting-profile.webp +0 -0
- package/avatars/free/seals-and-sea-lions/seal-big-whiskers-animated.webp +0 -0
- package/avatars/free/seals-and-sea-lions/seal-big-whiskers.webp +0 -0
- package/avatars/free/seals-and-sea-lions/seal-blinking-pup-animated.webp +0 -0
- package/avatars/free/seals-and-sea-lions/seal-blinking-pup.webp +0 -0
- package/avatars/free/seals-and-sea-lions/seal-blue-flipper-animated.webp +0 -0
- package/avatars/free/seals-and-sea-lions/seal-blue-flipper.webp +0 -0
- package/avatars/free/seals-and-sea-lions/seal-bunny-ears-animated.webp +0 -0
- package/avatars/free/seals-and-sea-lions/seal-bunny-ears.webp +0 -0
- package/avatars/free/seals-and-sea-lions/seal-heart-sunglasses-animated.webp +0 -0
- package/avatars/free/seals-and-sea-lions/seal-heart-sunglasses.webp +0 -0
- package/avatars/free/seals-and-sea-lions/seal-looking-back-animated.webp +0 -0
- package/avatars/free/seals-and-sea-lions/seal-looking-back.webp +0 -0
- package/avatars/free/seals-and-sea-lions/seal-side-eye-animated.webp +0 -0
- package/avatars/free/seals-and-sea-lions/seal-side-eye.webp +0 -0
- package/avatars/free/seals-and-sea-lions/seal-smiling-pup-animated.webp +0 -0
- package/avatars/free/seals-and-sea-lions/seal-smiling-pup.webp +0 -0
- package/avatars/free/seals-and-sea-lions/seal-upside-down-animated.webp +0 -0
- package/avatars/free/seals-and-sea-lions/seal-upside-down.webp +0 -0
- package/avatars/free/veggie-doodles/veggie-bok-choy.webp +0 -0
- package/avatars/free/veggie-doodles/veggie-broccoli.webp +0 -0
- package/avatars/free/veggie-doodles/veggie-cabbage.webp +0 -0
- package/avatars/free/veggie-doodles/veggie-eggplant.webp +0 -0
- package/avatars/free/veggie-doodles/veggie-garlic.webp +0 -0
- package/avatars/free/veggie-doodles/veggie-ginger.webp +0 -0
- package/avatars/free/veggie-doodles/veggie-leek.webp +0 -0
- package/avatars/free/veggie-doodles/veggie-potato.webp +0 -0
- package/avatars/free/veggie-doodles/veggie-purple-tomato.webp +0 -0
- package/avatars/free/veggie-doodles/veggie-scallion.webp +0 -0
- package/avatars/free/veggie-doodles/veggie-squash.webp +0 -0
- package/avatars/free/veggie-doodles/veggie-tomato.webp +0 -0
- package/avatars/terminal.json +1 -0
- package/cli.js +529 -0
- package/hooks/claude.json +14 -0
- package/logo.png +0 -0
- package/logo.svg +8 -0
- package/overlay/agents/antigravity.svg +1 -0
- package/overlay/agents/claude.svg +1 -0
- package/overlay/agents/codex.svg +1 -0
- package/overlay/agents/copilot.svg +1 -0
- package/overlay/control.html +528 -0
- package/overlay/index.html +365 -0
- package/overlay/main.js +361 -0
- package/overlay/preload.js +21 -0
- package/package.json +50 -4
- package/skills/agent-presence/SKILL.md +33 -0
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "agent-presence",
|
|
3
|
+
"owner": { "name": "agent-presence" },
|
|
4
|
+
"description": "Sticker overlay that shows what your AI coding agents and subagents are doing.",
|
|
5
|
+
"plugins": [
|
|
6
|
+
{
|
|
7
|
+
"name": "agent-presence",
|
|
8
|
+
"source": "./",
|
|
9
|
+
"description": "Agent Peeps: small stickers that show what your Claude Code agents and subagents are doing."
|
|
10
|
+
}
|
|
11
|
+
]
|
|
12
|
+
}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "agent-presence",
|
|
3
|
+
"version": "0.1.0",
|
|
4
|
+
"description": "Sends Claude Code activity (files, tools, subagents) to the Agent Peeps sticker overlay.",
|
|
5
|
+
"author": { "name": "agentpeeps contributors" },
|
|
6
|
+
"license": "MIT",
|
|
7
|
+
"keywords": ["overlay", "subagents", "presence", "stickers"],
|
|
8
|
+
"hooks": "./hooks/claude.json"
|
|
9
|
+
}
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "agent-presence",
|
|
3
|
+
"version": "0.1.0",
|
|
4
|
+
"description": "Sends Codex activity (files, commands, subagents) to the Agent Peeps sticker overlay.",
|
|
5
|
+
"author": { "name": "agentpeeps contributors" },
|
|
6
|
+
"license": "MIT",
|
|
7
|
+
"keywords": ["overlay", "subagents", "presence", "stickers", "desktop pet"],
|
|
8
|
+
"skills": "./skills/",
|
|
9
|
+
"hooks": {
|
|
10
|
+
"hooks": {
|
|
11
|
+
"SessionStart": [{ "hooks": [{ "type": "command", "command": "node \"$PLUGIN_ROOT/cli.js\" emit codex", "commandWindows": "node \"%PLUGIN_ROOT%\\cli.js\" emit codex", "async": true, "timeout": 3 }] }],
|
|
12
|
+
"UserPromptSubmit": [{ "hooks": [{ "type": "command", "command": "node \"$PLUGIN_ROOT/cli.js\" emit codex", "commandWindows": "node \"%PLUGIN_ROOT%\\cli.js\" emit codex", "async": true, "timeout": 3 }] }],
|
|
13
|
+
"PreToolUse": [{ "matcher": "*", "hooks": [{ "type": "command", "command": "node \"$PLUGIN_ROOT/cli.js\" emit codex", "commandWindows": "node \"%PLUGIN_ROOT%\\cli.js\" emit codex", "async": true, "timeout": 3 }] }],
|
|
14
|
+
"PostToolUse": [{ "matcher": "*", "hooks": [{ "type": "command", "command": "node \"$PLUGIN_ROOT/cli.js\" emit codex", "commandWindows": "node \"%PLUGIN_ROOT%\\cli.js\" emit codex", "async": true, "timeout": 3 }] }],
|
|
15
|
+
"PermissionRequest": [{ "matcher": "*", "hooks": [{ "type": "command", "command": "node \"$PLUGIN_ROOT/cli.js\" emit codex", "commandWindows": "node \"%PLUGIN_ROOT%\\cli.js\" emit codex", "async": true, "timeout": 3 }] }],
|
|
16
|
+
"SubagentStart": [{ "hooks": [{ "type": "command", "command": "node \"$PLUGIN_ROOT/cli.js\" emit codex", "commandWindows": "node \"%PLUGIN_ROOT%\\cli.js\" emit codex", "async": true, "timeout": 3 }] }],
|
|
17
|
+
"SubagentStop": [{ "hooks": [{ "type": "command", "command": "node \"$PLUGIN_ROOT/cli.js\" emit codex", "commandWindows": "node \"%PLUGIN_ROOT%\\cli.js\" emit codex", "async": true, "timeout": 3 }] }],
|
|
18
|
+
"Stop": [{ "hooks": [{ "type": "command", "command": "node \"$PLUGIN_ROOT/cli.js\" emit codex", "commandWindows": "node \"%PLUGIN_ROOT%\\cli.js\" emit codex", "async": true, "timeout": 3 }] }],
|
|
19
|
+
"SessionEnd": [{ "hooks": [{ "type": "command", "command": "node \"$PLUGIN_ROOT/cli.js\" emit codex", "commandWindows": "node \"%PLUGIN_ROOT%\\cli.js\" emit codex", "timeout": 3 }] }]
|
|
20
|
+
}
|
|
21
|
+
},
|
|
22
|
+
"interface": {
|
|
23
|
+
"displayName": "Agent Peeps",
|
|
24
|
+
"shortDescription": "Small stickers that show what your agents are doing",
|
|
25
|
+
"longDescription": "Floating sticker characters for every Codex and Claude Code session and subagent, with a tiny status icon and, on hover, the file or command each one is on. Runs locally; needs the Agent Peeps overlay from npm.",
|
|
26
|
+
"developerName": "agentpeeps contributors",
|
|
27
|
+
"category": "Productivity",
|
|
28
|
+
"capabilities": ["Read", "Write"],
|
|
29
|
+
"composerIcon": "./logo.png",
|
|
30
|
+
"logo": "./logo.png",
|
|
31
|
+
"brandColor": "#8FDCC6",
|
|
32
|
+
"defaultPrompt": [
|
|
33
|
+
"Use this image as my Codex sticker",
|
|
34
|
+
"Give my Explore subagents their own sticker",
|
|
35
|
+
"Start the Agent Peeps overlay"
|
|
36
|
+
],
|
|
37
|
+
"screenshots": []
|
|
38
|
+
}
|
|
39
|
+
}
|
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 agent-presence contributors
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,252 @@
|
|
|
1
|
-
|
|
1
|
+
<p align="center"><img src="logo.png" width="112" alt="Agent Peeps logo"></p>
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
<h1 align="center">Agent Peeps</h1>
|
|
4
|
+
|
|
5
|
+
<p align="center"><b>A tiny sticker for every AI coding agent, live on your screen.</b><br>
|
|
6
|
+
See which agent is on which file, what it's doing, and when it needs you.</p>
|
|
7
|
+
|
|
8
|
+
<p align="center">
|
|
9
|
+
<a href="https://www.npmjs.com/package/agentpeeps"><img src="https://img.shields.io/badge/npm-agentpeeps-2f4bff" alt="npm: agentpeeps"></a>
|
|
10
|
+
<a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-121214" alt="MIT license"></a>
|
|
11
|
+
<img src="https://img.shields.io/badge/local%20only-no%20account%2C%20no%20network-7fd99a" alt="Local only">
|
|
12
|
+
</p>
|
|
13
|
+
|
|
14
|
+
<p align="center">
|
|
15
|
+
<a href="#install">Install</a> ·
|
|
16
|
+
<a href="#commands">Commands</a> ·
|
|
17
|
+
<a href="#your-own-stickers">Stickers</a> ·
|
|
18
|
+
<a href="#how-it-works">How it works</a> ·
|
|
19
|
+
<a href="https://agentpeeps.space">Website</a> ·
|
|
20
|
+
<a href="https://agentpeeps.space/docs.html">Docs</a>
|
|
21
|
+
</p>
|
|
22
|
+
|
|
23
|
+
<p align="center"><img src="docs/readme/demo.gif" width="760" alt="A capybara sticker in the corner of the screen shows Claude writing login.ts while a helper sticker reads the tests"></p>
|
|
24
|
+
|
|
25
|
+
<p align="center"><code>npx agentpeeps init</code></p>
|
|
26
|
+
|
|
27
|
+
<div align="center">
|
|
28
|
+
<table>
|
|
29
|
+
<tr>
|
|
30
|
+
<td align="center" width="120"><img src="docs/readme/agents/claude.svg" width="36" height="36" alt=""><br><sub><b>Claude Code</b></sub></td>
|
|
31
|
+
<td align="center" width="120"><img src="docs/readme/agents/codex.svg" width="36" height="36" alt=""><br><sub><b>Codex</b></sub></td>
|
|
32
|
+
<td align="center" width="120"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/readme/agents/copilot-dark.svg"><img src="docs/readme/agents/copilot.svg" width="36" height="36" alt=""></picture><br><sub><b>GitHub Copilot</b></sub></td>
|
|
33
|
+
<td align="center" width="120"><img src="docs/readme/agents/antigravity.svg" width="36" height="36" alt=""><br><sub><b>Antigravity</b></sub></td>
|
|
34
|
+
<td align="center" width="120"><img src="docs/readme/agents/vscode.svg" width="36" height="36" alt=""><br><sub><b>VS Code</b></sub></td>
|
|
35
|
+
</tr>
|
|
36
|
+
</table>
|
|
37
|
+
</div>
|
|
38
|
+
|
|
39
|
+
One sticker per Claude Code, Codex, Copilot or Antigravity session, a smaller one for each subagent (helper), and a tiny icon for what it's doing: reading, writing, running, done, or needs you. Hover for the file it's on.
|
|
40
|
+
|
|
41
|
+
- Works with **Claude Code** (CLI, desktop app, IDE), **Codex**, **GitHub Copilot** (VS Code agent mode and Copilot CLI) and **Antigravity**, because it listens to the agents' own hooks, not to an editor.
|
|
42
|
+
- Floats above everything, VS Code included. Clicks pass straight through except on the stickers.
|
|
43
|
+
- Local only: no server, no account, no network.
|
|
44
|
+
- npm: `agentpeeps`. The old `agent-presence` command still works, and settings stay in `~/.agent-presence`.
|
|
45
|
+
|
|
46
|
+
## Install
|
|
47
|
+
|
|
48
|
+
```bash
|
|
49
|
+
npx agentpeeps init # adds hooks for every supported agent it finds (backups are kept)
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
The stickers appear on your next agent session (or start them now with `npx agentpeeps overlay`).
|
|
53
|
+
Because npx runs from a cache it may clear, `init` first installs a permanent copy into `~/.agent-presence/app` and points the hooks there. Run it again any time to update.
|
|
54
|
+
|
|
55
|
+
Prefer a global install? Same result:
|
|
56
|
+
|
|
57
|
+
```bash
|
|
58
|
+
npm i -g agentpeeps
|
|
59
|
+
agentpeeps init
|
|
60
|
+
agentpeeps overlay # start the stickers (also auto-starts on your next agent session)
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
| Agent | Where `init` writes |
|
|
64
|
+
|---|---|
|
|
65
|
+
| Claude Code | `~/.claude/settings.json` |
|
|
66
|
+
| Codex | `~/.codex/hooks.json` |
|
|
67
|
+
| Copilot | `~/.copilot/hooks/agent-presence.json` (VS Code agent mode and Copilot CLI both read it) |
|
|
68
|
+
| Antigravity | `~/.gemini/config/hooks.json`, under the `agent-presence` key |
|
|
69
|
+
|
|
70
|
+
Pick some with `agentpeeps init copilot antigravity`.
|
|
71
|
+
|
|
72
|
+
Codex asks you to trust new hooks once: open `/hooks` in Codex and approve the Agent Peeps entries.
|
|
73
|
+
Copilot and Antigravity load hooks at startup, so restart them after `init`. Their hooks can't run in the background, so Agent Peeps only listens to events that can't hold up or block the agent: a tool call shows up when it finishes, not when it starts.
|
|
74
|
+
|
|
75
|
+
### Or as plugins (hooks + a customize-my-sticker skill; the overlay still comes from npm)
|
|
76
|
+
|
|
77
|
+
<p align="center"><img src="docs/readme/ask-your-agent.gif" width="760" alt="Claude Code is asked to set up Agent Peeps, runs agentpeeps init and three set commands, and the new stickers appear in the corner on the next session"></p>
|
|
78
|
+
<p align="center"><sub>Or skip the commands: ask your agent to set it up and pick its own stickers.</sub></p>
|
|
79
|
+
|
|
80
|
+
**Claude Code**
|
|
81
|
+
|
|
82
|
+
```
|
|
83
|
+
/plugin marketplace add watermelon588/agent-presence
|
|
84
|
+
/plugin install agent-presence@agent-presence
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
**Codex** (CLI or desktop app)
|
|
88
|
+
|
|
89
|
+
```bash
|
|
90
|
+
codex plugin marketplace add watermelon588/agent-presence
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
Then open `/plugins` in Codex, install **Agent Peeps**, and approve its hooks when Codex asks (Codex never trusts plugin hooks automatically). Plugins with hooks can't be listed in OpenAI's public plugin directory, so this GitHub marketplace is the install path.
|
|
94
|
+
|
|
95
|
+
Use either the plugin or `agentpeeps init` for an agent, not both, or every event is recorded twice.
|
|
96
|
+
|
|
97
|
+
### In VS Code (also Cursor, Windsurf, Antigravity)
|
|
98
|
+
|
|
99
|
+
The [`vscode/`](vscode/) extension reads the same event log and adds:
|
|
100
|
+
|
|
101
|
+
- **Explorer badges**: solid initials in each agent's color (🅒 Claude, 🅧 Codex, 🅟 Copilot, 🅐 Antigravity; helpers show their type's initial, e.g. 🅔 Explore), with folders lighting up around active files
|
|
102
|
+
- an **Agents** view in the Explorer with each agent's sticker, its subagents and the files it touched
|
|
103
|
+
|
|
104
|
+
Until it's on the Marketplace / Open VSX: `code --install-extension vscode/agent-presence-vscode-0.1.0.vsix`
|
|
105
|
+
|
|
106
|
+
## Commands
|
|
107
|
+
|
|
108
|
+
| Command | What it does |
|
|
109
|
+
|---|---|
|
|
110
|
+
| `agentpeeps init [agent...]` | Install hooks: `claude`, `codex`, `copilot`, `antigravity` (default: every one found) |
|
|
111
|
+
| `agentpeeps uninstall [agent...]` | Remove only our hooks |
|
|
112
|
+
| `agentpeeps overlay` / `--quit` | Start / stop the floating stickers |
|
|
113
|
+
| `agentpeeps control [agent]` | Open the control room (optionally straight on one agent's stickers) |
|
|
114
|
+
| `agentpeeps packs` | List sticker packs |
|
|
115
|
+
| `agentpeeps set <target> <pack|image|default>` | Give an agent, a model (`model:opus`), helpers or a helper type its stickers |
|
|
116
|
+
| `agentpeeps watch` | Live view in the terminal: a small color pixel sticker per agent and helper (it hops while working, shakes when it needs you), then the files each one touched. Redraws in place, so it only takes the lines it needs |
|
|
117
|
+
| `agentpeeps show [pack|agent|all] [--once]` | Preview the terminal stickers: 75 clean ones, including the official model logos (`show`, `show claude`, `show pixel-food`, `show all`). Busy stickers aren't in the terminal set; agents using one show their logo there instead |
|
|
118
|
+
| `agentpeeps emit <agent> [event]` | Used by the hooks: reads hook JSON on stdin |
|
|
119
|
+
|
|
120
|
+
### Control room (no config editing, no agent, no tokens)
|
|
121
|
+
|
|
122
|
+
Press `Ctrl+Alt+Shift+C`, click the **tray icon** (next to the clock) or run `agentpeeps control`. One window holds everything, and it opens instantly.
|
|
123
|
+
|
|
124
|
+
<p align="center"><img src="docs/readme/control-room/overview.webp" width="760" alt="The control room's Overview page with numbered labels: the four pages, the live session count, the on-screen switch, totals, a session card that needs you, its helpers, its sticker and hide buttons, the activity log and the sticker targets"></p>
|
|
125
|
+
|
|
126
|
+
- **Overview**: every live session with its sticker, model, folder, what it's doing, its helpers, tool calls, files touched and time on task, plus a running activity log.
|
|
127
|
+
- **Display**: size, when to show an agent, details, motion (lively / calm / off), status icon, resting opacity, helper layout (joining line / dashed pod / side by side), which agents to show, and **Only over my apps**: hide the stickers whenever an app other than your editor or terminal is in front.
|
|
128
|
+
- **Bubbles**: speech bubbles on or off, card or text only, border, theme (auto: white text in dark mode, black in light), text color, text size, open by itself when an agent needs you, stats line. With a live preview.
|
|
129
|
+
- **Shortcuts**: every global shortcut, whether it's ready or taken by another app, and one switch to turn them off.
|
|
130
|
+
- **Stickers**: one set per agent, per agent's helpers, every helper, a helper type (Explore, test-writer...) or a model rule. Pick several and each session or helper gets its own.
|
|
131
|
+
|
|
132
|
+
The full visual tour, with every page and setting labeled: **[docs/control-room.md](docs/control-room.md)**.
|
|
133
|
+
|
|
134
|
+
<p align="center"><img src="docs/readme/control-room/bubble.webp" width="560" alt="A speech bubble over a Claude sticker, labeled: name, model and folder, status, current file, recent files, stats line, status icon, helpers joined by a line"></p>
|
|
135
|
+
|
|
136
|
+
### Keyboard shortcuts
|
|
137
|
+
|
|
138
|
+
`Ctrl+Alt+Shift` (`⌘⌥⇧` on macOS) plus:
|
|
139
|
+
|
|
140
|
+
| Key | Does | | Key | Does |
|
|
141
|
+
|---|---|---|---|---|
|
|
142
|
+
| `A` | Show or hide the stickers | | `S` | Next size |
|
|
143
|
+
| `C` | Open the control room | | `W` | When to show an agent |
|
|
144
|
+
| `F` | Everywhere / only over my apps | | `L` | Helper layout |
|
|
145
|
+
| `B` | Speech bubbles on or off | | `M` | Motion: lively, calm, off |
|
|
146
|
+
| `P` | Peek: open every bubble | | `H` | Hide for 30 minutes |
|
|
147
|
+
| `T` | Bubble theme | | `R` | Reset positions |
|
|
148
|
+
| `D` | Details in the bubble or always | | | |
|
|
149
|
+
|
|
150
|
+
A toast at the bottom of the screen confirms each one. Turn them off in the control room if they clash with another app (`A` always works).
|
|
151
|
+
|
|
152
|
+
### On the stickers
|
|
153
|
+
|
|
154
|
+
- **Hover** for who it is, what it's doing, its recent files (click one to show it in its folder) and its stats.
|
|
155
|
+
- **Click** to pin the bubble open. A bubble also opens by itself when an agent needs you.
|
|
156
|
+
- **Drag** a sticker to put that agent anywhere; each agent remembers its spot.
|
|
157
|
+
- **Right-click** to change or hide just that one, peek at every bubble, hide everything for 30 minutes, or quit.
|
|
158
|
+
|
|
159
|
+
By default the stickers are small and disappear a few seconds after an agent finishes. Until you pick stickers, each agent shows its own logo. Helpers are joined to their agent by a thin line in its color.
|
|
160
|
+
|
|
161
|
+
## Your own stickers
|
|
162
|
+
|
|
163
|
+
<p align="center"><img src="docs/readme/stickers.png" width="760" alt="Ten stickers from the built-in packs: plush blobs, gradient icons, pixel characters, color blobs, a flame and a purple octopus"></p>
|
|
164
|
+
|
|
165
|
+
### Packs, from the terminal
|
|
166
|
+
|
|
167
|
+
<p align="center"><img src="docs/readme/customize.gif" width="760" alt="The terminal runs agentpeeps set claude capybaras, set codex cats and set helpers fruit-cats, and the stickers in the corner swap as each command runs"></p>
|
|
168
|
+
|
|
169
|
+
15 free packs come built in: plush-blobs, gradient-icons, pixel-food, color-blobs, flame-expressions, monster-icons, retro-windows, capybaras, cats and more. Your own pack is a folder of images in `~/.agent-presence/stickers/<pack name>/`. Point any agent, model or helper at one:
|
|
170
|
+
|
|
171
|
+
```bash
|
|
172
|
+
agentpeeps packs # list your packs
|
|
173
|
+
agentpeeps set claude capybaras # every Claude session gets a capybara
|
|
174
|
+
agentpeeps set codex cats
|
|
175
|
+
agentpeeps set model:opus capybaras # sessions on a model containing "opus"
|
|
176
|
+
agentpeeps set model:fable cats
|
|
177
|
+
agentpeeps set helpers fruit-cats # every subagent
|
|
178
|
+
agentpeeps set claude-helpers critters # only Claude's subagents
|
|
179
|
+
agentpeeps set Explore detective.png # one subagent type, one image
|
|
180
|
+
agentpeeps set claude default # back to Claude's logo
|
|
181
|
+
```
|
|
182
|
+
|
|
183
|
+
A session uses its model rule first (the longest match wins), then its agent. A helper uses its type, then its agent's helpers, then every helper. Images added to a pack later are picked up automatically. Claude Code and Antigravity report the model; for agents that don't, model rules simply don't apply.
|
|
184
|
+
|
|
185
|
+
### Or click
|
|
186
|
+
|
|
187
|
+
Drop images into `~/.agent-presence/stickers/` (subfolders become groups) and pick them in the control room, or use **Add from my computer…** there. Any PNG, GIF (animated works), SVG, WebP or JPEG; square, about 256 px, looks best.
|
|
188
|
+
|
|
189
|
+
The control room writes `~/.agent-presence/config.json`, which you (or an agent) can also edit by hand; the overlay applies changes live:
|
|
190
|
+
|
|
191
|
+
```json
|
|
192
|
+
{
|
|
193
|
+
"avatars": {
|
|
194
|
+
"claude": "pack:plush-blobs",
|
|
195
|
+
"model:opus": ["~/stickers/fox.gif", "~/stickers/owl.png"],
|
|
196
|
+
"codex": "~/stickers/robot.png",
|
|
197
|
+
"subagent": "~/stickers/sprout.svg",
|
|
198
|
+
"Explore": "~/stickers/detective.png",
|
|
199
|
+
"test-writer": "~/stickers/bee.png"
|
|
200
|
+
},
|
|
201
|
+
"names": { "claude": "Foxy" },
|
|
202
|
+
"size": "small",
|
|
203
|
+
"show": "working",
|
|
204
|
+
"details": "hover",
|
|
205
|
+
"agents": { "copilot": false },
|
|
206
|
+
"autostart": true,
|
|
207
|
+
"scope": "apps",
|
|
208
|
+
"apps": ["Code", "Cursor", "WindowsTerminal"],
|
|
209
|
+
"helpers": "line",
|
|
210
|
+
"motion": "lively",
|
|
211
|
+
"opacity": 80,
|
|
212
|
+
"shortcuts": true,
|
|
213
|
+
"bubble": { "on": true, "style": "card", "border": true, "theme": "auto", "text": "auto", "size": "medium", "auto": true, "stats": true }
|
|
214
|
+
}
|
|
215
|
+
```
|
|
216
|
+
|
|
217
|
+
Sticker keys: an agent (`claude`, `codex`, `copilot`, `antigravity`), `<agent>-subagent` for that agent's helpers, `subagent` for every helper, or a helper type (`Explore`, `test-writer`, anything you named). A helper uses its type first, then its agent's helpers, then every helper. A list gives each session (or helper) one of its images. Every other key is listed in [docs/control-room.md](docs/control-room.md#settings-file).
|
|
218
|
+
|
|
219
|
+
## How it works
|
|
220
|
+
|
|
221
|
+
```
|
|
222
|
+
Claude Code hooks ─┐
|
|
223
|
+
Codex hooks ───────┤
|
|
224
|
+
Copilot hooks ─────┼─ agentpeeps emit ─→ ~/.agent-presence/events.jsonl ─→ overlay (Electron) / watch (terminal) / VS Code
|
|
225
|
+
Antigravity hooks ─┘
|
|
226
|
+
```
|
|
227
|
+
|
|
228
|
+
Every hook appends one JSON line (agent, session, subagent id/type, state, file). The emitter never blocks or fails the agent: it always exits 0, swallows errors (set `AGENT_PRESENCE_DEBUG=1` to see them), runs async where the agent allows it, and never registers a hook whose output decides permissions.
|
|
229
|
+
|
|
230
|
+
States: `idle`, `thinking`, `reading`, `writing`, `running`, `delegating`, `browsing`, `waiting` (needs your permission), `done`.
|
|
231
|
+
|
|
232
|
+
## Develop
|
|
233
|
+
|
|
234
|
+
```bash
|
|
235
|
+
npm install
|
|
236
|
+
node node_modules/electron/install.js # fetch the Electron binary once
|
|
237
|
+
npm test # parser + installer checks
|
|
238
|
+
npm run overlay # terminal 1
|
|
239
|
+
npm run demo # terminal 2: plays fake Claude, Codex, Copilot and Antigravity sessions
|
|
240
|
+
```
|
|
241
|
+
|
|
242
|
+
`AGENT_PRESENCE_HOME=<dir>` points everything at a scratch folder. `AGENT_PRESENCE_SNAPSHOT=out.png` makes the overlay save a picture of the dock and quit.
|
|
243
|
+
|
|
244
|
+
## Roadmap
|
|
245
|
+
|
|
246
|
+
- Publish the VS Code extension to the Marketplace and Open VSX (Cursor, Windsurf and Antigravity install from Open VSX)
|
|
247
|
+
- OpenCode, DeepSeek Harness hooks
|
|
248
|
+
- Copilot / Antigravity: show tool calls as they start, if they get a non-blocking pre-tool hook
|
|
249
|
+
- Move the Codex manifest to the newer root `plugin.json` (`extensions.com.openai`) once Codex versions without it are gone
|
|
250
|
+
- Sticker packs
|
|
251
|
+
|
|
252
|
+
MIT
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|