Documentation
¶
Index ¶
- func CleanupStaleSessions(baseDir string, maxAge time.Duration) (int, error)
- func FormatSessionID(baseDir, sessionID string) string
- func GetCurrentBranch() string
- func ParseDuration(s string) (time.Duration, error)
- func Save(baseDir string, sess *Session) error
- type AgentFingerprint
- type AgentType
- type Session
- func ForceNewSession(baseDir string) (*Session, error)
- func Get(baseDir string) (*Session, error)
- func GetOrCreate(baseDir string) (*Session, error)
- func GetWithContextCheck(baseDir string) (*Session, error)
- func ListSessions(baseDir string) ([]Session, error)
- func SetName(baseDir string, name string) (*Session, error)
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func CleanupStaleSessions ¶ added in v0.4.26
CleanupStaleSessions removes session files older than maxAge (handles nested structure)
func FormatSessionID ¶
FormatSessionID formats a session ID with optional name lookup. Use this when you only have a session ID string and need to display it. If the session has a name, returns "ses_xxx (name)", otherwise just "ses_xxx".
func GetCurrentBranch ¶ added in v0.4.26
func GetCurrentBranch() string
GetCurrentBranch returns the current git branch (exported for display)
func ParseDuration ¶
ParseDuration parses human-readable duration strings
Types ¶
type AgentFingerprint ¶ added in v0.4.26
type AgentFingerprint struct {
Type AgentType
PID int
ExplicitID string // set when TD_SESSION_ID is used
}
AgentFingerprint identifies a specific agent session
func GetAgentFingerprint ¶ added in v0.4.26
func GetAgentFingerprint() AgentFingerprint
GetAgentFingerprint detects the agent running this process by walking the process tree
func (AgentFingerprint) String ¶ added in v0.4.26
func (af AgentFingerprint) String() string
String returns a filesystem-safe string representation
type AgentType ¶ added in v0.4.26
type AgentType string
AgentType identifies the type of AI agent
const ( AgentClaudeCode AgentType = "claude-code" AgentCursor AgentType = "cursor" AgentCodex AgentType = "codex" AgentWindsurf AgentType = "windsurf" AgentZed AgentType = "zed" AgentAider AgentType = "aider" AgentCopilot AgentType = "copilot" AgentGemini AgentType = "gemini" AgentUnknown AgentType = "unknown" AgentTerminal AgentType = "terminal" )
type Session ¶
type Session struct {
ID string `json:"id"`
Name string `json:"name,omitempty"`
Branch string `json:"branch,omitempty"` // git branch for session scoping
AgentType string `json:"agent_type,omitempty"` // agent type (claude-code, cursor, terminal, etc.)
AgentPID int `json:"agent_pid,omitempty"` // stable parent agent process ID
ContextID string `json:"context_id,omitempty"` // audit only, not used for matching
PreviousSessionID string `json:"previous_session_id,omitempty"`
StartedAt time.Time `json:"started_at"`
LastActivity time.Time `json:"last_activity,omitempty"` // heartbeat for session liveness
IsNew bool `json:"-"` // True if session was just created (not persisted)
}
Session represents the current terminal session
func ForceNewSession ¶
ForceNewSession creates a new session on the current branch/agent, regardless of existing session
func GetOrCreate ¶
GetOrCreate returns the current session for the current git branch and agent. Sessions are scoped by branch + agent fingerprint - same agent on same branch = same session. Creates a new session if none exists for this branch/agent combination.
func GetWithContextCheck ¶
GetWithContextCheck returns the current session and checks if context changed. If context changed, creates a new session automatically.
func ListSessions ¶ added in v0.4.26
ListSessions returns all sessions (agent-scoped and legacy branch-scoped)
func (*Session) Display ¶
Display returns the session ID with name if set: "ses_abc123 (my-name)" or just "ses_abc123"
func (*Session) DisplayWithAgent ¶ added in v0.4.26
DisplayWithAgent returns session info including agent: "ses_abc123 [claude-code]" or with name
Source Files