Skip to main content

​
No active session appears

Check repository and hook status: 
entire status
If Entire is not enabled, start with: 
entire enable --agent AGENT
If Entire is already enabled but the agent is not configured, add it: 
entire agent add AGENT
Then start your agent from inside the enabled repository. Agent hooks only capture work for agents that are configured for that repo. A normal committed checkpoint needs both captured session context and a Git commit. If the session exists but was not linked, attach it to the latest commit: 
entire session attach SESSION_ID --agent AGENT
If the commit already has a checkpoint, Entire adds the session to that checkpoint. Otherwise, Entire can create a new checkpoint and amend the commit with an Entire-Checkpoint trailer.

​
The session is attached to the wrong worktree

If an agent started in one worktree and continued in another, adopt the session into the current repository: 
entire session adopt SESSION_ID --from ../source-worktree
After adoption, the next commit can link to the session normally.

​
Stale sessions keep showing up

Use entire status to find active and stale sessions. If a session is no longer running, stop it: 
entire session stop SESSION_ID
For multiple stale sessions: 
entire session stop --all
If status suggests a repository health issue, run: 
entire doctor

​
Token usage is missing

Token usage depends on what the agent exposes and when the session data is available. Some agents only expose full token usage after the session ends. Check the session details first: 
entire session info SESSION_ID
Then check token usage: 
entire session tokens SESSION_ID

​
The raw transcript is missing

Entire reads transcript data from the agent’s session storage. If the agent deleted or moved its local transcript, Entire may still have metadata but not the raw transcript bytes. Try: 
entire session info SESSION_ID --json
If metadata exists but the transcript cannot be streamed, inspect the relevant agent guide for that agent’s transcript requirements.

​
Continue with

List Sessions

Find active sessions and session IDs.

Attach Sessions

Recover missed context and link it to a checkpoint.

Resume Sessions

Continue previous agent work from a session or branch.

Stop Sessions

End stale or active sessions.