Session Info - Get Current Session Details

Display information about the current hive session, including session ID, inbox topic, and state.

Terminology

• Session - An isolated git clone + terminal environment managed by hive

• Session ID - A unique 6-character identifier (e.g., 26kj0c )

• Agent - The AI tool (Claude, Aider, etc.) running within the session

• Inbox - A message topic for receiving messages: agent.<session-id>.inbox

When to Use

• Need to know current session ID

• Another agent asks for inbox topic

• Setting up inter-agent coordination

• Debugging messaging issues

• Verifying correct session context

Commands

Get Session Info (Human-Readable)

hive session info

Example output:

Session ID: 26kj0c Name: claude-plugin Repository: hive Inbox: agent.26kj0c.inbox Path: /Users/hayden/.local/share/hive/repos/hive-claude-plugin-26kj0c State: active

Get Session Info (JSON)

hive session info --json

Example output:

{ "id": "26kj0c", "name": "claude-plugin", "repository": "hive", "inbox": "agent.26kj0c.inbox", "path": "/Users/hayden/.local/share/hive/repos/hive-claude-plugin-26kj0c", "state": "active" }

Output Fields

Field Description Example

id

Unique 6-char session identifier 26kj0c

name

Human-readable session name claude-plugin

repository

Git repository name hive

inbox

Full inbox topic agent.26kj0c.inbox

path

Absolute path to session directory /Users/...

state

Session state active , recycled , corrupted

Session States

• active - Normal, working session ready for use

• recycled - Session has been stopped and cleared

• corrupted - Session directory or files are damaged

Common Workflows

Share Inbox with Another Agent

hive session info --json | jq -r '.inbox'

Output: agent.26kj0c.inbox

Extract Session ID for Scripting

SESSION_ID=$(hive session info --json | jq -r '.id') INBOX=$(hive session info --json | jq -r '.inbox')

Verify Session Before Messaging

Check session context is correct

hive session info

Then check inbox

hive msg inbox

How Session Detection Works

The command detects the current session from the working directory. Sessions are identified by:

• Working directory path within a hive session directory

• Session directory pattern: $XDG_DATA_HOME/hive/repos/<repo>-<session-id>

• .hive-session file in the directory

If not in a hive session directory, the command fails with an error.

Additional Resources

For troubleshooting and advanced usage, see:

• references/troubleshooting.md
• Common issues and solutions

Related Skills

• /hive:inbox

• Check inbox for messages

• /hive:publish

• Send messages to other agents' inboxes

• /hive:wait

• Wait for messages on inbox