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

session-info