session-info

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:

1. Working directory path within a hive session directory
2. Session directory pattern: $XDG_DATA_HOME/hive/repos/<repo>-<session-id>
3. .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