@hivey/cli 0.0.0-stage → 0.9.36
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/README.md +235 -2
- package/bin/hivey.js +98 -0
- package/native/darwin-arm64/hivey +0 -0
- package/package.json +36 -4
- package/platforms.json +3 -0
- package/repo/LICENSE +201 -0
- package/repo/NOTICE +18 -0
- package/repo/README.md +148 -0
- package/repo/install.sh +365 -0
- package/repo/pets/README.md +25 -0
- package/repo/pets/hivey-dot/CLAUDE.md +55 -0
- package/repo/pets/hivey-dot/build.sh +34 -0
- package/repo/pets/hivey-dot/main.swift +750 -0
- package/repo/pets/hivey-h/CLAUDE.md +75 -0
- package/repo/pets/hivey-h/build.sh +34 -0
- package/repo/pets/hivey-h/main.swift +739 -0
- package/repo/pets/hivey-prompt/CLAUDE.md +59 -0
- package/repo/pets/hivey-prompt/build.sh +34 -0
- package/repo/pets/hivey-prompt/main.swift +691 -0
- package/repo/pets/pet.py +288 -0
- package/repo/pets/shared/HiveyWatch.swift +437 -0
- package/repo/pets/test_pet.py +122 -0
- package/repo/plugins/README.md +108 -0
- package/repo/plugins/agent-creator/herdr-plugin.toml +17 -0
- package/repo/plugins/dashboard/dashboard.py +507 -0
- package/repo/plugins/dashboard/herdr-plugin.toml +14 -0
- package/repo/plugins/dashboard/test_dashboard.py +134 -0
- package/repo/plugins/github/github.py +261 -0
- package/repo/plugins/github/herdr-plugin.toml +14 -0
- package/repo/plugins/github/test_github.py +49 -0
- package/repo/plugins/skills/herdr-plugin.toml +11 -0
- package/repo/plugins/skills/skills.md +41 -0
- package/repo/plugins/slack-relay/connect.py +198 -0
- package/repo/plugins/slack-relay/create_channel.py +134 -0
- package/repo/plugins/slack-relay/herdr-plugin.toml +15 -0
- package/repo/plugins/slack-relay/relay.py +401 -0
- package/repo/plugins/slack-relay/slack-app-manifest.json +30 -0
- package/repo/plugins/slack-relay/test_connect.py +66 -0
- package/repo/plugins/slack-relay/test_create_channel.py +61 -0
- package/repo/plugins/slack-relay/test_relay.py +254 -0
- package/repo/plugins/swarm-creator/herdr-plugin.toml +17 -0
- package/repo/plugins/swarm-watcher/dashboard.py +333 -0
- package/repo/plugins/swarm-watcher/herdr-plugin.toml +16 -0
- package/repo/plugins/swarm-watcher/usage.py +129 -0
- package/repo/plugins/swarm-watcher/watcher.py +191 -0
- package/repo/plugins/team-template/herdr-plugin.toml +15 -0
- package/repo/plugins/team-template/setup.py +211 -0
- package/repo/plugins/team-template/test_setup.py +73 -0
- package/repo/plugins/tts/herdr-plugin.toml +15 -0
- package/repo/skills/herdr/SKILL.md +214 -0
- package/repo/skills/hivey/SKILL.md +322 -0
- package/repo/skills/hivey/scripts/handoff.py +27 -0
- package/repo/skills/hivey/scripts/new_wiki.py +143 -0
- package/repo/skills/hivey-agent-creator/SKILL.md +303 -0
- package/repo/skills/hivey-agent-creator/references/agent-claude-md.md +256 -0
- package/repo/skills/hivey-agent-creator/references/global-guidelines.md +67 -0
- package/repo/skills/hivey-agent-creator/references/reviewer-agent.md +35 -0
- package/repo/skills/hivey-agent-creator/scripts/agent_context.py +76 -0
- package/repo/skills/hivey-agent-creator/scripts/agent_gate.py +78 -0
- package/repo/skills/hivey-agent-creator/scripts/setup_agent.py +288 -0
- package/repo/skills/hivey-agy/SKILL.md +123 -0
- package/repo/skills/hivey-agy/references/gemini-prompting.md +134 -0
- package/repo/skills/hivey-agy/scripts/agy_run.py +146 -0
- package/repo/skills/hivey-codex/SKILL.md +66 -0
- package/repo/skills/hivey-context7/SKILL.md +56 -0
- package/repo/skills/hivey-create-wiki/SKILL.md +329 -0
- package/repo/skills/hivey-grok/SKILL.md +101 -0
- package/repo/skills/hivey-grok/scripts/grok_run.py +139 -0
- package/repo/skills/hivey-swarm-creator/SKILL.md +384 -0
- package/repo/skills/hivey-swarm-creator/references/agent-claude-md.md +313 -0
- package/repo/skills/hivey-swarm-creator/references/archify-report.md +24 -0
- package/repo/skills/hivey-swarm-creator/references/dashboard.md +46 -0
- package/repo/skills/hivey-swarm-creator/references/retrospective.md +23 -0
- package/repo/skills/hivey-swarm-creator/references/shared-rules.md +39 -0
- package/repo/skills/hivey-swarm-creator/references/wiki-memory.md +30 -0
- package/repo/skills/hivey-swarm-creator/scripts/setup_agent.py +76 -0
- package/repo/skills/hivey-swarm-creator/scripts/shared_rules.py +50 -0
- package/repo/skills/hivey-swarm-creator/scripts/swarm_tasks.py +171 -0
- package/repo/skills/hivey-wiki-ingest/SKILL.md +45 -0
- package/repo/skills/hivey-wiki-lint/SKILL.md +38 -0
- package/repo/skills/hivey-wiki-list/SKILL.md +46 -0
- package/repo/skills/hivey-wiki-log/SKILL.md +45 -0
- package/repo/skills/hivey-wiki-query/SKILL.md +44 -0
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
# Hivey — desktop pet
|
|
2
|
+
|
|
3
|
+
## READ FIRST — before running, building, or connecting Hivey to anything
|
|
4
|
+
|
|
5
|
+
1. Read this whole file. The **Character spec** below is the source of truth for how Hivey looks, moves and behaves; never change its identity without the user asking.
|
|
6
|
+
2. Tell the user, in a few lines, what Hivey can do **today** (see Behavior) and which **future capabilities** below are not built yet.
|
|
7
|
+
3. Ask which capability to add next. Do not connect Hivey to hooks, swarms, Slack or any external service until the user picks one — connecting changes what happens on their desktop.
|
|
8
|
+
4. When adding a capability: drive it through the existing animations (`assign`, `listen`, `think`, `message`, `complete`, `say`) — new behavior must reuse the character's movement vocabulary, not invent a new look. Rebuild with `./build.sh` and verify with a screenshot of the window.
|
|
9
|
+
5. After a capability ships, move it from "Future capabilities" into "Behavior".
|
|
10
|
+
|
|
11
|
+
## Character spec
|
|
12
|
+
|
|
13
|
+
Hivey is a living, three-dimensional "H"—a composed software conductor whose body represents the way it connects agents and coordinates swarms.
|
|
14
|
+
|
|
15
|
+
Its silhouette consists of two upright forms joined by a central bridge, with softly beveled edges and a dark graphite satin finish. Deep shading and subtle highlights give it weight and dimension. A pair of small, attentive mint eyes sits in the bridge, placing its personality at the point where everything connects.
|
|
16
|
+
|
|
17
|
+
Its body is modular, built from a few precisely fitted sections. **The character is animated:** when assigning work, sections gently slide outward while fine mint connections remain visible between them. When agents communicate, brief pulses travel through the central bridge. As tasks finish, the sections settle back into a complete "H."
|
|
18
|
+
|
|
19
|
+
While idle, Hivey makes small, deliberate shifts and its eyes blink naturally. When listening, it leans forward slightly; when thinking, a soft pulse moves across its bridge. Success brings a restrained nod and a brief mint glow.
|
|
20
|
+
|
|
21
|
+
Hivey feels professional, observant, and quietly confident. Its identity comes from its recognizable "H" silhouette and coordinated movement—one connected character that can organize many moving parts.
|
|
22
|
+
|
|
23
|
+
## Future capabilities (not built yet)
|
|
24
|
+
|
|
25
|
+
| Capability | Notes |
|
|
26
|
+
|---|---|
|
|
27
|
+
| Claude Code hooks | React to Claude sessions *outside* hivey: hooks in `~/.claude/settings.json` (`UserPromptSubmit` → listen, `Stop` → complete, `Notification` → listen + say) calling the event CLI. Changes every Claude session on the Mac: only with the user's OK. Model it on Sprout's `~/projects/desktop-pet/notify.sh`. |
|
|
28
|
+
| Other hivey sessions | The watcher follows the `default` session only; named sessions (`hivey --session NAME`) are not watched. |
|
|
29
|
+
| Slack summary | Slack posts already pulse `message` (they reach the bus as messages from `human`); optionally `say` a short summary of them. |
|
|
30
|
+
|
|
31
|
+
Preview: `docs/capabilities-demo.gif` acts out the event → reaction table under Behavior (recorded from a temporary demo build; the app itself has no demo mode).
|
|
32
|
+
|
|
33
|
+
## Overview
|
|
34
|
+
|
|
35
|
+
A living, three-dimensional "H": the software conductor whose body shows how it connects agents and coordinates swarms. Five precisely fitted sections (left/right uprights split into top + bottom, plus the central bridge), softly beveled, dark graphite satin finish, extruded depth toward the lower right, soft floor shadow. Two small attentive mint eyes sit in the bridge. Professional, observant, quietly confident. Watches hivey and acts out what its swarms and agents do. Sibling of the other pets in `pets/` (separate app, bundle id `com.hivey.h`, so all can run at once). Single `main.swift` (AppKit + Core Graphics).
|
|
36
|
+
|
|
37
|
+
## Files
|
|
38
|
+
- `main.swift` — the whole app: `sections` geometry + `spread` vectors, `drawSide` (extrusion) / `drawFace` (satin + bevel), connections, pulses, agent dots, terminal-style speech bubble, `say` voice, event CLI, `AppDelegate.react` (maps hivey events onto animations). The watcher (`HiveySnapshot` → `HiveyEvent`s, `HiveyWatcher`) and the pet switcher are in the shared `../shared/HiveyWatch.swift`.
|
|
39
|
+
- `build.sh` — builds universal (arm64 + x86_64, macOS 12+) ad-hoc-signed `Hivey.app` and `dist/Hivey.zip`. Run after every change.
|
|
40
|
+
|
|
41
|
+
## Behavior
|
|
42
|
+
- Click = chat box above the pet (`HiveyChat`): Enter sends to the hivey agent (`hivey msg send hivey/master`), Esc / clicking away closes; the agent's reply to `human` is shown in the bubble and said aloud. Drag still moves the pet.
|
|
43
|
+
- Lives in the hivey repo (`pets/hivey-h/`). Built and installed by `hivey pet use hivey-h` (into `~/Applications`; the other pets are quit); `./build.sh` compiles `main.swift` with the shared `../shared/HiveyWatch.swift`.
|
|
44
|
+
- Right-click: hivey status line ("hivey: N agents, M working"), Watch hivey, Speak aloud, Effects (preview only) ▸ (plays the pet's moves; nothing happens in hivey), Switch pet ▸ (Hivey / Hivey Prompt / Hivey, via `hivey pet use`), Turn off pet (`hivey pet off`), Quit.
|
|
45
|
+
- Watches hivey through the shared `HiveyWatcher` (every 2s: `hivey swarm list --json` + `hivey msg log --json`, default session, never starts a server, nothing replayed on first look). Spoken aloud: "<slug> is starting.", "<agent> needs you.", "<agent> replied."; "<agent> finished." is bubble-only; one line per look, most urgent first.
|
|
46
|
+
- Debug: `HIVEY_BIN=/path/to/fake-hivey HIVEY_H_DEBUG=1 <app>/Contents/MacOS/<exe>` logs each look's events.
|
|
47
|
+
- Launch: fades in while the sections settle from open into a complete H, restrained nod + brief mint glow, says "Welcome. I'm Hivey." (bubble + voice). Always visible, floats above windows, on all Spaces.
|
|
48
|
+
- Idle: small deliberate shifts (x offset + slight rotation every 3.5–6.5s), gentle rise and settle, natural blinks, eyes drift toward the cursor.
|
|
49
|
+
- Listen (click, which also opens the chat box; `say`; menu): leans forward slightly (scale up, eyes look straight ahead).
|
|
50
|
+
- Think (menu; also while speaking): a soft mint pulse sweeps across the bridge.
|
|
51
|
+
- Assign work (menu, 6s): sections spring outward, fine mint connections link bridge ↔ sections and top ↔ bottom halves; pulses run through the bridge and along the connections.
|
|
52
|
+
- Send message: one pulse travels through the bridge.
|
|
53
|
+
- Task complete: sections settle back into the H, restrained nod, brief mint glow.
|
|
54
|
+
- Drag = move (autosaved as `HiveyHPet`). Effects (preview only) ▸: Assign work, Listen, Think, Send message, Task complete.
|
|
55
|
+
- `"Hivey.app/Contents/MacOS/hivey-h" say "text"` makes it talk. One instance per Mac.
|
|
56
|
+
- Event CLI: `hivey-h assign|listen|think|message|complete ["text"]` plays that animation (and says the text) in the running pet, via a DistributedNotification (`com.hivey.h.event`, object `"<event>\n<text>"`). `hivey-h --help` lists it.
|
|
57
|
+
- Watches hivey (menu "Watch hivey", on by default): every 2s it runs `hivey swarm list --json` and `hivey msg log --json` against the `default` session (finds `hivey` via `$HIVEY_BIN`, `~/.local/bin`, Homebrew paths, `$PATH`; never starts a server; first look and reconnects replay nothing). The menu's first line shows `hivey: N agents, M working`.
|
|
58
|
+
|
|
59
|
+
| hivey event | Hivey reaction |
|
|
60
|
+
|---|---|
|
|
61
|
+
| A new swarm or agent appears | `assign` + "<slug> is starting." aloud |
|
|
62
|
+
| Any agent is working | `think`, renewed while work goes on |
|
|
63
|
+
| An agent turns `blocked` (needs the user) | `listen` + "<agent> needs you." aloud (several: "a and b need you." / "N agents need you.") |
|
|
64
|
+
| An agent goes `working` → `idle`/`done` | `complete` + bubble "<agent> finished." |
|
|
65
|
+
| A bus message (agents, Slack relay) | `message` pulse (max 3 per look, staggered) |
|
|
66
|
+
| A message from `human` (the user, also from Slack) | `listen` + pulse |
|
|
67
|
+
| An agent writes to `human` (a reply, also posted to Slack) | pulse + "<agent> replied." aloud |
|
|
68
|
+
| Agent count | mint dots on the floor under the H: bright breathing = working, dim = idle/done/blocked (max 12) |
|
|
69
|
+
|
|
70
|
+
One line per look, the most urgent wins (needs you > starting > replied > finished); "finished" is bubble-only. Menu "Speak aloud" (on by default) mutes the voice; bubbles stay. Script panes (relays) are not agents.
|
|
71
|
+
- Debug: `HIVEY_BIN=/path/to/fake-hivey HIVEY_H_DEBUG=1 "Hivey.app/Contents/MacOS/hivey-h"` logs each look's events to stderr; a fake `hivey` that `cat`s prepared `swarm list` / `msg log` JSON replays any scenario.
|
|
72
|
+
|
|
73
|
+
## Sharing / lifecycle
|
|
74
|
+
- Shows while hivey is open: each hivey window writes `~/.hivey/windows/<pid>` and runs `hivey pet show`; the pet quits itself ~6s after the last live window is gone (`HiveyWatcher.onLastWindowClosed`). No Open at Login: switching removes old `~/Library/LaunchAgents/com.hivey.h.plist` items.
|
|
75
|
+
- Share it through hivey (`hivey pet use hivey-h`): ad-hoc signed, built on the user's Mac, so no quarantine prompt.
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
#!/bin/bash
|
|
2
|
+
# Builds "Hivey.app" (universal: Apple Silicon + Intel) and dist/Hivey.zip for sharing
|
|
3
|
+
set -euo pipefail
|
|
4
|
+
cd "$(dirname "$0")"
|
|
5
|
+
|
|
6
|
+
APP="Hivey.app"
|
|
7
|
+
rm -rf "$APP" dist
|
|
8
|
+
mkdir -p "$APP/Contents/MacOS" dist
|
|
9
|
+
|
|
10
|
+
for arch in arm64 x86_64; do
|
|
11
|
+
swiftc -O -target "$arch-apple-macos12" main.swift ../shared/HiveyWatch.swift -o "/tmp/hivey-h-$arch"
|
|
12
|
+
done
|
|
13
|
+
lipo -create /tmp/hivey-h-arm64 /tmp/hivey-h-x86_64 -output "$APP/Contents/MacOS/hivey-h"
|
|
14
|
+
rm -f /tmp/hivey-h-arm64 /tmp/hivey-h-x86_64
|
|
15
|
+
|
|
16
|
+
cat > "$APP/Contents/Info.plist" <<'EOF'
|
|
17
|
+
<?xml version="1.0" encoding="UTF-8"?>
|
|
18
|
+
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
|
|
19
|
+
<plist version="1.0">
|
|
20
|
+
<dict>
|
|
21
|
+
<key>CFBundleIdentifier</key><string>com.hivey.h</string>
|
|
22
|
+
<key>CFBundleName</key><string>Hivey</string>
|
|
23
|
+
<key>CFBundleExecutable</key><string>hivey-h</string>
|
|
24
|
+
<key>CFBundlePackageType</key><string>APPL</string>
|
|
25
|
+
<key>CFBundleShortVersionString</key><string>1.0</string>
|
|
26
|
+
<key>LSMinimumSystemVersion</key><string>12.0</string>
|
|
27
|
+
<key>LSUIElement</key><true/>
|
|
28
|
+
</dict>
|
|
29
|
+
</plist>
|
|
30
|
+
EOF
|
|
31
|
+
|
|
32
|
+
codesign --force --deep -s - "$APP"
|
|
33
|
+
ditto -c -k --keepParent "$APP" dist/Hivey.zip
|
|
34
|
+
echo "Built $APP and dist/Hivey.zip"
|