@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,59 @@
|
|
|
1
|
+
# Hivey Prompt — desktop pet
|
|
2
|
+
|
|
3
|
+
## READ FIRST — before running, building, or connecting Hivey Prompt to anything
|
|
4
|
+
|
|
5
|
+
1. Read this whole file. The **Character spec** below is the source of truth for how Hivey and its three agents look, move and behave; never change its identity without the user asking.
|
|
6
|
+
2. Tell the user, in a few lines, what Hivey Prompt 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 it to anything new Hivey Prompt 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 (`attend`, `work`, `emit`, `complete`, `say`) and the agent `spots` modes (`idle` / `gather` / `swarm`) — new behavior must reuse the character's movement vocabulary, not invent a new look. No circular orbits or planetary rings, ever. Rebuild with `./build.sh` and verify with a screenshot (use `screencapture -R` on the real desktop for shadows; see note under Behavior).
|
|
9
|
+
5. After a capability ships, move it from "Future capabilities" into "Behavior".
|
|
10
|
+
|
|
11
|
+
## Character spec
|
|
12
|
+
|
|
13
|
+
Hivey is a three-dimensional dot with a deep charcoal-teal body and a crisp mint `>_` face. Its surface has a satin finish, with directional lighting, subtle highlights, and rich shading across its sides and underside. A soft shadow beneath it gives it weight and depth.
|
|
14
|
+
|
|
15
|
+
Three smaller emerald and muted mint agent dots surround Hivey at different heights and depths. Each is a solid, shaded sphere. Some sit slightly behind Hivey, while others float nearer the viewer, creating a dimensional group.
|
|
16
|
+
|
|
17
|
+
The agents are animated: they gently hover nearby, gather when Hivey receives instructions, and separate into coordinated formations when a swarm starts working. Short light pulses pass between them when they communicate. Their movement feels deliberate and organized, without circular orbits or planetary rings.
|
|
18
|
+
|
|
19
|
+
Hivey's cursor blinks slowly while idle and pulses while working. Its movements remain restrained and professional. The overall impression is a composed terminal conductor surrounded by its active team—dark, tactile, and clearly three-dimensional.
|
|
20
|
+
|
|
21
|
+
## Future capabilities (not built yet)
|
|
22
|
+
|
|
23
|
+
| Capability | Notes |
|
|
24
|
+
|---|---|
|
|
25
|
+
| Live team size | Show the real number of agents (fixed at three today) by adding/removing agent spheres with new `spots`, keeping the dimensional group (mix of behind and in front, no rings). |
|
|
26
|
+
| Claude Code hooks | React to Claude sessions *outside* hivey via hooks in `~/.claude/settings.json` calling the event CLI. Only with the user's OK. |
|
|
27
|
+
| Slack summary | Slack posts already pulse; optionally `say` a short summary. |
|
|
28
|
+
|
|
29
|
+
## Overview
|
|
30
|
+
|
|
31
|
+
A three-dimensional satin sphere: deep charcoal-teal body, crisp mint `>_` face, directional lighting (key light upper-left, floor bounce light underneath, soft specular), soft contact shadow. Three smaller shaded agent spheres (emerald + muted mint) surround it at different heights and depths — some behind Hivey, some nearer the viewer. No orbits or rings. Professional, composed, precise. Watches hivey and acts out its swarms, agents and messages. Sibling of the other pets in `pets/` (separate app, bundle id `com.hivey.prompt`, so all can run at once). Single `main.swift` (AppKit + Core Graphics).
|
|
32
|
+
|
|
33
|
+
## Files
|
|
34
|
+
- `main.swift` — the whole app: `drawSphere`/`drawShadow` 3D shading, pet animation, terminal-style speech bubble, `say` voice.
|
|
35
|
+
- `build.sh` — builds universal (arm64 + x86_64, macOS 12+) ad-hoc-signed `Hivey Prompt.app` and `dist/HiveyPrompt.zip`. Run after every change.
|
|
36
|
+
|
|
37
|
+
## Behavior
|
|
38
|
+
- 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.
|
|
39
|
+
- Lives in the hivey repo (`pets/hivey-prompt/`). Built and installed by `hivey pet use hivey-prompt` (into `~/Applications`; the other pets are quit); `./build.sh` compiles `main.swift` with the shared `../shared/HiveyWatch.swift`.
|
|
40
|
+
- 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.
|
|
41
|
+
- 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.
|
|
42
|
+
- Debug: `HIVEY_BIN=/path/to/fake-hivey HIVEY_H_DEBUG=1 <app>/Contents/MacOS/<exe>` logs each look's events.
|
|
43
|
+
- hivey → Hivey Prompt: swarm/agent starts → `work` · agents working → `keepWorking` (formation renewed; an `attend` gather is not interrupted) · agent needs you / message from the user → `attend` · message → `pulse()` between agents · agent finished → `complete`.
|
|
44
|
+
- Event CLI: `"Hivey Prompt.app/Contents/MacOS/hivey-prompt" attend|work|emit|complete ["text"]` (DistributedNotification `com.hivey.prompt.event`).
|
|
45
|
+
- Agents spring toward per-mode spots `(x, y, z)` in `spots` (`idle` / `gather` / `swarm`); z sets draw order, size and haze. Modes expire back to idle.
|
|
46
|
+
- Launch: fades in, message pulses out to agents, agents report back, restrained nod + brief mint glow, says "Welcome. I'm Hivey." (bubble + voice). Always visible, floats above windows, on all Spaces.
|
|
47
|
+
- Idle: Hivey rises and settles; `_` cursor blinks slowly; agents hover at different depths; occasional pulse between agents or to Hivey.
|
|
48
|
+
- Instructions (click, which also opens the chat box; `say`; menu): face tilts in attention, agents gather close (3s).
|
|
49
|
+
- Start swarm (menu, 8s): agents spread into a triangle formation, bob in sync, steady message pulses; cursor pulses.
|
|
50
|
+
- Dispatch message: a pulse from Hivey to each agent.
|
|
51
|
+
- Task complete: agents report back (pulses to Hivey), nod + brief glow, back to idle.
|
|
52
|
+
- While speaking the `_` flickers like typing (no mouth).
|
|
53
|
+
- Drag = move (autosaved as `HiveyPromptPet`). Effects (preview only) ▸: Give instructions, Start swarm, Dispatch message, Task complete.
|
|
54
|
+
- `"Hivey Prompt.app/Contents/MacOS/hivey-prompt" say "text"` makes it talk. One instance per Mac.
|
|
55
|
+
- Window-only screenshots (`screencapture -l`) show the floor shadow wrongly light on dark backgrounds; it composites correctly on the real desktop.
|
|
56
|
+
|
|
57
|
+
## Sharing / lifecycle
|
|
58
|
+
- 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.prompt.plist` items.
|
|
59
|
+
- Share it through hivey (`hivey pet use hivey-prompt`): ad-hoc signed, built on the user's Mac, so no quarantine prompt.
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
#!/bin/bash
|
|
2
|
+
# Builds "Hivey Prompt.app" (universal: Apple Silicon + Intel) and dist/HiveyPrompt.zip for sharing
|
|
3
|
+
set -euo pipefail
|
|
4
|
+
cd "$(dirname "$0")"
|
|
5
|
+
|
|
6
|
+
APP="Hivey Prompt.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-prompt-$arch"
|
|
12
|
+
done
|
|
13
|
+
lipo -create /tmp/hivey-prompt-arm64 /tmp/hivey-prompt-x86_64 -output "$APP/Contents/MacOS/hivey-prompt"
|
|
14
|
+
rm -f /tmp/hivey-prompt-arm64 /tmp/hivey-prompt-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.prompt</string>
|
|
22
|
+
<key>CFBundleName</key><string>Hivey Prompt</string>
|
|
23
|
+
<key>CFBundleExecutable</key><string>hivey-prompt</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/HiveyPrompt.zip
|
|
34
|
+
echo "Built $APP and dist/HiveyPrompt.zip"
|