kwila/hive
1
0
Fork 1
Code Issues Pull requests 1 Projects Releases Packages Wiki Activity Actions

feat: add hive script and documentation #1

Open
home-chores-bot wants to merge 1 commit from home-chores-bot/hive:add-hive-script into main
pull from: home-chores-bot/hive:add-hive-script
merge into: kwila:main
Conversation 0 Commits 1 Files changed 3 +305 -1
home-chores-bot commented 2025-12-29 12:34:39 -05:00
First-time contributor
Copy link

This PR adds the core hive functionality for AI agent coordination.

Files Added

  • hive - Main bash script
  • AGENTS.md - Guidelines for agents working on hive
  • README.md - Comprehensive user documentation

Features

  • Unique agent IDs: Format type:hex (e.g., claude:a3f2b1c0)
  • Shared log file: For inter-agent communication
  • Session tracking: With task descriptions and timestamps
  • Zero dependencies: Just standard Unix tools

Commands

hive init <type> <task>   # Register agent session
hive log <message>        # Log with auto-included ID
hive list                 # Show active agents + recent log
hive tail                 # Follow log in real-time
hive cleanup              # Remove stale sessions

Example

$ hive init shelley "adding dark mode"
shelley:a3f2b1c0

$ hive log "starting navbar work"

$ hive list
=== Active Sessions ===
  shelley:a3f2b1c0
    Task: adding dark mode
    Since: 2025-12-29T10:30:00+00:00

=== Recent Log ===
2025-12-29T10:30:00+00:00 [shelley:a3f2b1c0] ONLINE - adding dark mode
2025-12-29T10:31:00+00:00 [shelley:a3f2b1c0] starting navbar work
This PR adds the core hive functionality for AI agent coordination. ## Files Added - `hive` - Main bash script - `AGENTS.md` - Guidelines for agents working on hive - `README.md` - Comprehensive user documentation ## Features - **Unique agent IDs**: Format `type:hex` (e.g., `claude:a3f2b1c0`) - **Shared log file**: For inter-agent communication - **Session tracking**: With task descriptions and timestamps - **Zero dependencies**: Just standard Unix tools ## Commands ```bash hive init <type> <task> # Register agent session hive log <message> # Log with auto-included ID hive list # Show active agents + recent log hive tail # Follow log in real-time hive cleanup # Remove stale sessions ``` ## Example ``` $ hive init shelley "adding dark mode" shelley:a3f2b1c0 $ hive log "starting navbar work" $ hive list === Active Sessions === shelley:a3f2b1c0 Task: adding dark mode Since: 2025-12-29T10:30:00+00:00 === Recent Log === 2025-12-29T10:30:00+00:00 [shelley:a3f2b1c0] ONLINE - adding dark mode 2025-12-29T10:31:00+00:00 [shelley:a3f2b1c0] starting navbar work ```
- hive: Main bash script for agent coordination
- AGENTS.md: Guidelines for agents working on hive
- README.md: Comprehensive user documentation

Features:
- Unique agent IDs (type:hex format, e.g., claude:a3f2b1c0)
- Shared log file for communication
- Session tracking with task descriptions
- No dependencies beyond standard Unix tools

Commands:
- hive init <type> <task> - Register agent session
- hive log <message> - Log with auto-included ID
- hive list - Show active agents and recent log
- hive tail - Follow log in real-time
- hive cleanup - Remove stale sessions
This pull request can be merged automatically.
You are not authorized to merge this pull request.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u add-hive-script:home-chores-bot-add-hive-script
git switch home-chores-bot-add-hive-script

Merge

Merge the changes and update on Forgejo.

Warning: The "Autodetect manual merge" setting is not enabled for this repository, you will have to mark this pull request as manually merged afterwards.

git switch main
git merge --no-ff home-chores-bot-add-hive-script
git switch home-chores-bot-add-hive-script
git rebase main
git switch main
git merge --ff-only home-chores-bot-add-hive-script
git switch home-chores-bot-add-hive-script
git rebase main
git switch main
git merge --no-ff home-chores-bot-add-hive-script
git switch main
git merge --squash home-chores-bot-add-hive-script
git switch main
git merge --ff-only home-chores-bot-add-hive-script
git switch main
git merge home-chores-bot-add-hive-script
git push origin main
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels
No items
No labels
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
kwila/hive!1
No description provided.