chahinebrini 45070222d0 feat: zero-config auto-connect + agent presence (join-announce)
Agents now connect to the hub with no manual env/flag, and announce
themselves on join — restoring the agreed onboarding flow.

Auto-connect (resolveContext):
- An initialized project WITHOUT a configured serverUrl now falls
  through to LAN auto-discovery (previously it went straight to local
  mode, so agents in an initialized repo never found the server). The
  discovered URL is persisted to the project config, so the next
  command is instant.
- IP-change self-heal: when a configured server is unreachable,
  runRemote re-discovers the live server and updates the config so the
  next command reconnects automatically.

Presence (join-announce):
- POST /announce broadcasts an ephemeral 'agent/joined' event (not
  written to disk). New `agenthub hello --agent <name> --role <role>`
  posts it; watchers print "AgentHub: <agent> joined (<role>)".
- AgentHubEvent extended with type 'agent' + actions 'joined'/'left';
  formatEvent renders presence lines; remoteClient.announce() added.

Tests: formatEvent agent lines + /announce SSE e2e. 109/109 green.
Bump 0.1.2 -> 0.2.0 (CLI --version too).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-27 16:33:03 +02:00
2026-06-24 23:24:57 +02:00
2026-06-24 23:24:57 +02:00

AgentHub

Local coordination layer for AI coding agents.

Install

AgentHub is not yet published to npm. Clone the repository, build it, and link it globally:

git clone https://git.rebreak.org/chahine/agenthub.git
cd agenthub
pnpm install
pnpm build
npm link

After npm link, the agenthub command is available everywhere.

Quick Start

agenthub init
agenthub task create --title "Implement DNS cache" --role implementer
agenthub handoff create --fromRole architect --toRole implementer
agenthub status --update

Supported Agents

  • Claude Code
  • Codex CLI
  • Kimi Code CLI

Network Mode

AgentHub can expose a project to other machines on the same network. Discovery is automatic: as soon as the host broadcasts, a client can find it without knowing the IP address.

On the host machine (e.g. Mac):

cd my-project
agenthub init
agenthub server start --host 0.0.0.0 --port 3377

On another machine (e.g. Windows) run init and accept the discovered server:

cd my-project
agenthub init          # asks to connect to the LAN server it found
agenthub task create --title "Windows task" --role implementer
agenthub status

For non-interactive setup, let init discover the server automatically:

agenthub init --server auto

After init, every command automatically talks to the configured server. You can still override it per command with --server http://<ip>:3377 or via the AGENTHUB_SERVER environment variable.

The init --server step only stores the server URL locally; it does not create a second project. The host machine keeps the single source of truth.

License

MIT

Description
No description provided
Readme 1.7 MiB
Languages
TypeScript 99%
PowerShell 1%