Documentation
¶
Index ¶
- Constants
- func ClearMCPCache(projectPath string)
- func ClearProjectMCPs(projectPath string) error
- func CreateExampleConfig() error
- func CreateProfile(profile string) error
- func DeleteProfile(profile string) error
- func FindSessionForInstance(projectPath string, createdAfter time.Time, excludeIDs map[string]bool) string
- func GetAgentDeckDir() (string, error)
- func GetAvailableMCPNames() []string
- func GetAvailableMCPs() map[string]MCPDef
- func GetClaudeConfigDir() string
- func GetClaudeSessionID(projectPath string) (string, error)
- func GetConfigPath() (string, error)
- func GetDefaultTool() string
- func GetEffectiveProfile(explicit string) string
- func GetGlobalMCPNames() []string
- func GetGlobalPool() *mcppool.Pool
- func GetGroupLevel(path string) int
- func GetProfileDir(profile string) (string, error)
- func GetProfilesDir() (string, error)
- func GetProjectMCPNames(projectPath string) []string
- func GetStoragePath() (string, error)
- func GetStoragePathForProfile(profile string) (string, error)
- func GetToolBusyPatterns(toolName string) []string
- func GetToolIcon(toolName string) string
- func GetUserConfigPath() (string, error)
- func GroupByProject(instances []*Instance) map[string][]*Instance
- func InitializeGlobalPool(ctx context.Context, config *UserConfig, sessions []*Instance) (*mcppool.Pool, error)
- func ListProfiles() ([]string, error)
- func NeedsMigration() (bool, error)
- func ProfileExists(profile string) (bool, error)
- func SaveConfig(config *Config) error
- func SetDefaultProfile(profile string) error
- func ShutdownGlobalPool() error
- func TierName(tier SearchTier) string
- func ToggleLocalMCP(projectPath, mcpName string) error
- func UpdateClaudeSessionsWithDedup(instances []*Instance)
- func WriteGlobalMCP(enabledNames []string) error
- func WriteMCPJsonFromConfig(projectPath string, enabledNames []string) error
- type ClaudeConfig
- type ClaudeProject
- type ClaudeSettings
- type Config
- type FileTracker
- type GlobalSearchIndex
- func (idx *GlobalSearchIndex) Close()
- func (idx *GlobalSearchIndex) EntryCount() int
- func (idx *GlobalSearchIndex) FuzzySearch(query string) []*SearchResult
- func (idx *GlobalSearchIndex) GetTier() SearchTier
- func (idx *GlobalSearchIndex) IsLoading() bool
- func (idx *GlobalSearchIndex) Search(query string) []*SearchResult
- type GlobalSearchSettings
- type Group
- type GroupData
- type GroupTree
- func (t *GroupTree) AddSession(inst *Instance)
- func (t *GroupTree) CollapseGroup(path string)
- func (t *GroupTree) CreateGroup(name string) *Group
- func (t *GroupTree) CreateSubgroup(parentPath, name string) *Group
- func (t *GroupTree) DeleteGroup(path string) []*Instance
- func (t *GroupTree) ExpandGroup(path string)
- func (t *GroupTree) ExpandGroupWithParents(path string)
- func (t *GroupTree) Flatten() []Item
- func (t *GroupTree) GetAllInstances() []*Instance
- func (t *GroupTree) GetGroupNames() []string
- func (t *GroupTree) GetGroupPaths() []string
- func (t *GroupTree) GroupCount() int
- func (t *GroupTree) MoveGroupDown(path string)
- func (t *GroupTree) MoveGroupUp(path string)
- func (t *GroupTree) MoveSessionDown(inst *Instance)
- func (t *GroupTree) MoveSessionToGroup(inst *Instance, newGroupPath string)
- func (t *GroupTree) MoveSessionUp(inst *Instance)
- func (t *GroupTree) RemoveSession(inst *Instance)
- func (t *GroupTree) RenameGroup(oldPath, newName string)
- func (t *GroupTree) SessionCount() int
- func (t *GroupTree) ShallowCopyForSave() *GroupTree
- func (t *GroupTree) SyncWithInstances(instances []*Instance)
- func (t *GroupTree) ToggleGroup(path string)
- type Instance
- func DiscoverExistingTmuxSessions(existingInstances []*Instance) ([]*Instance, error)
- func FilterByQuery(instances []*Instance, query string) []*Instance
- func NewInstance(title, projectPath string) *Instance
- func NewInstanceWithGroup(title, projectPath, groupPath string) *Instance
- func NewInstanceWithGroupAndTool(title, projectPath, groupPath, tool string) *Instance
- func NewInstanceWithTool(title, projectPath, tool string) *Instance
- func (i *Instance) CanFork() bool
- func (i *Instance) CanRestart() bool
- func (i *Instance) CaptureLoadedMCPs()
- func (inst *Instance) ClearParent()
- func (i *Instance) CreateForkedInstance(newTitle, newGroupPath string) (*Instance, string, error)
- func (i *Instance) Exists() bool
- func (i *Instance) Fork(newTitle, newGroupPath string) (string, error)
- func (i *Instance) GetActualWorkDir() string
- func (inst *Instance) GetLastActivityTime() time.Time
- func (i *Instance) GetLastResponse() (*ResponseOutput, error)
- func (i *Instance) GetMCPInfo() *MCPInfo
- func (i *Instance) GetSessionIDFromTmux() string
- func (i *Instance) GetTmuxSession() *tmux.Session
- func (i *Instance) HasUpdated() bool
- func (inst *Instance) IsSubSession() bool
- func (i *Instance) Kill() error
- func (inst *Instance) MarkAccessed()
- func (i *Instance) Preview() (string, error)
- func (i *Instance) PreviewFull() (string, error)
- func (i *Instance) Restart() error
- func (inst *Instance) SetParent(parentID string)
- func (i *Instance) Start() error
- func (i *Instance) StartWithMessage(message string) error
- func (i *Instance) UpdateClaudeSession(excludeIDs map[string]bool)
- func (i *Instance) UpdateStatus() error
- func (i *Instance) WaitForClaudeSession(maxWait time.Duration) string
- func (i *Instance) WaitForClaudeSessionWithExclude(maxWait time.Duration, excludeIDs map[string]bool) string
- type InstanceData
- type Item
- type ItemType
- type LocalMCP
- type LogSettings
- type MCPDef
- type MCPInfo
- type MCPMode
- type MCPPoolSettings
- type MCPServer
- type MCPServerConfig
- type MatchRange
- type MigrationResult
- type ProjectMCPSettings
- type ResponseOutput
- type SearchEntry
- type SearchResult
- type SearchTier
- type Status
- type Storage
- func (s *Storage) GetUpdatedAt() (time.Time, error)
- func (s *Storage) Load() ([]*Instance, error)
- func (s *Storage) LoadWithGroups() ([]*Instance, []*GroupData, error)
- func (s *Storage) Profile() string
- func (s *Storage) Save(instances []*Instance) error
- func (s *Storage) SaveWithGroups(instances []*Instance, groupTree *GroupTree) error
- type StorageData
- type ToolDef
- type UserConfig
Constants ¶
const ( // DefaultProfile is the name of the default profile DefaultProfile = "default" // ProfilesDirName is the directory containing all profiles ProfilesDirName = "profiles" // ConfigFileName is the global config file name ConfigFileName = "config.json" )
const DefaultGroupName = "My Sessions"
DefaultGroupName is the display name for the default group where ungrouped sessions go
const DefaultGroupPath = "my-sessions"
DefaultGroupPath is the normalized path for the default group (used for lookups and protection)
const TierThresholdBalanced = 500 * 1024 * 1024
TierThresholdBalanced is the max size for balanced tier (500MB)
const TierThresholdInstant = 100 * 1024 * 1024
TierThresholdInstant is the max size for instant tier (100MB)
const UserConfigFileName = "config.toml"
UserConfigFileName is the TOML config file for user preferences
Variables ¶
This section is empty.
Functions ¶
func ClearMCPCache ¶ added in v0.5.3
func ClearMCPCache(projectPath string)
ClearMCPCache invalidates the MCP cache for a project path
func ClearProjectMCPs ¶ added in v0.5.3
ClearProjectMCPs removes all MCPs from projects[path].mcpServers in Claude's config
func CreateExampleConfig ¶ added in v0.3.0
func CreateExampleConfig() error
CreateExampleConfig creates an example config file if none exists
func CreateProfile ¶ added in v0.3.0
CreateProfile creates a new empty profile
func DeleteProfile ¶ added in v0.3.0
DeleteProfile deletes a profile and all its data
func FindSessionForInstance ¶ added in v0.4.1
func FindSessionForInstance(projectPath string, createdAfter time.Time, excludeIDs map[string]bool) string
FindSessionForInstance finds the session file for a specific instance Parameters:
- projectPath: the project directory
- createdAfter: only consider files with internal timestamp >= this time
- excludeIDs: session IDs already claimed by other instances
Returns the session ID or empty string if not found ¶
Note: This function uses internal timestamp as the primary filter. For FORKED sessions (where internal timestamp is inherited from parent), we also check if the file was CREATED very recently (ModTime within 30s of now), which indicates it's a newly created fork file, not an actively updated conversation.
func GetAgentDeckDir ¶ added in v0.3.0
GetAgentDeckDir returns the base agent-deck directory (~/.agent-deck)
func GetAvailableMCPNames ¶ added in v0.5.3
func GetAvailableMCPNames() []string
GetAvailableMCPNames returns sorted list of MCP names from config.toml
func GetAvailableMCPs ¶ added in v0.5.3
GetAvailableMCPs returns MCPs from config.toml as a map This replaces the old catalog-based approach with explicit user configuration
func GetClaudeConfigDir ¶ added in v0.4.1
func GetClaudeConfigDir() string
GetClaudeConfigDir returns the Claude config directory Priority: 1) CLAUDE_CONFIG_DIR env, 2) UserConfig setting, 3) ~/.claude
func GetClaudeSessionID ¶ added in v0.4.1
GetClaudeSessionID returns the ACTIVE session ID for a project path It first tries to find the currently running session by checking recently modified .jsonl files, then falls back to lastSessionId from config
func GetConfigPath ¶ added in v0.3.0
GetConfigPath returns the path to the global config file
func GetDefaultTool ¶ added in v0.4.3
func GetDefaultTool() string
GetDefaultTool returns the user's preferred default tool for new sessions Returns empty string if not configured (defaults to shell)
func GetEffectiveProfile ¶ added in v0.3.0
GetEffectiveProfile returns the profile to use, considering: 1. Explicitly provided profile (from -p flag) 2. Environment variable AGENTDECK_PROFILE 3. Config default profile 4. Fallback to "default"
func GetGlobalMCPNames ¶ added in v0.5.3
func GetGlobalMCPNames() []string
GetGlobalMCPNames returns the names of MCPs currently in Claude's global config
func GetGlobalPool ¶ added in v0.6.2
GetGlobalPool returns the global pool instance (may be nil if disabled)
func GetGroupLevel ¶
GetGroupLevel returns the nesting level of a group (0 for root, 1 for child, etc.)
func GetProfileDir ¶ added in v0.3.0
GetProfileDir returns the path to a specific profile's directory
func GetProfilesDir ¶ added in v0.3.0
GetProfilesDir returns the path to the profiles directory
func GetProjectMCPNames ¶ added in v0.5.3
GetProjectMCPNames returns MCPs from projects[path].mcpServers in Claude's config
func GetStoragePath ¶
GetStoragePath returns the path to the sessions.json file for the default profile. DEPRECATED: Use GetStoragePathForProfile for explicit profile support.
func GetStoragePathForProfile ¶ added in v0.3.0
GetStoragePathForProfile returns the path to the sessions.json file for a specific profile.
func GetToolBusyPatterns ¶ added in v0.3.0
GetToolBusyPatterns returns busy patterns for a tool (custom + built-in)
func GetToolIcon ¶ added in v0.3.0
GetToolIcon returns the icon for a tool (custom or built-in)
func GetUserConfigPath ¶ added in v0.3.0
GetUserConfigPath returns the path to the user config file
func GroupByProject ¶
GroupByProject groups sessions by their parent project directory
func InitializeGlobalPool ¶ added in v0.6.2
func InitializeGlobalPool(ctx context.Context, config *UserConfig, sessions []*Instance) (*mcppool.Pool, error)
InitializeGlobalPool creates and starts the global MCP pool
func ListProfiles ¶ added in v0.3.0
ListProfiles returns all available profile names
func NeedsMigration ¶ added in v0.3.0
NeedsMigration checks if migration from old layout is needed
func ProfileExists ¶ added in v0.3.0
ProfileExists checks if a profile exists
func SaveConfig ¶ added in v0.3.0
SaveConfig saves the global configuration
func SetDefaultProfile ¶ added in v0.3.0
SetDefaultProfile sets the default profile in the config
func ShutdownGlobalPool ¶ added in v0.6.2
func ShutdownGlobalPool() error
ShutdownGlobalPool stops the global pool
func TierName ¶ added in v0.5.3
func TierName(tier SearchTier) string
TierName returns a human-readable name for the tier
func ToggleLocalMCP ¶ added in v0.5.3
ToggleLocalMCP toggles a Local MCP on/off It respects the existing mode (whitelist vs blacklist) or initializes with blacklist
func UpdateClaudeSessionsWithDedup ¶ added in v0.4.1
func UpdateClaudeSessionsWithDedup(instances []*Instance)
UpdateClaudeSessionsWithDedup updates Claude sessions for all instances with deduplication This should be called from the manager/storage layer that has access to all instances It both fixes existing duplicates AND prevents new duplicates during detection
func WriteGlobalMCP ¶ added in v0.5.3
WriteGlobalMCP adds or removes MCPs from Claude's global config This modifies ~/.claude-work/.claude.json → mcpServers
func WriteMCPJsonFromConfig ¶ added in v0.5.3
WriteMCPJsonFromConfig writes enabled MCPs from config.toml to project's .mcp.json
Types ¶
type ClaudeConfig ¶ added in v0.4.1
type ClaudeConfig struct {
Projects map[string]ClaudeProject `json:"projects"`
}
ClaudeConfig represents the structure of .claude.json
type ClaudeProject ¶ added in v0.4.1
type ClaudeProject struct {
LastSessionId string `json:"lastSessionId"`
}
ClaudeProject represents a project entry in Claude's config
type ClaudeSettings ¶ added in v0.4.1
type ClaudeSettings struct {
// ConfigDir is the path to Claude's config directory
// Default: ~/.claude (or CLAUDE_CONFIG_DIR env var)
ConfigDir string `toml:"config_dir"`
// DangerousMode enables --dangerously-skip-permissions flag for Claude sessions
// Default: false
DangerousMode bool `toml:"dangerous_mode"`
}
ClaudeSettings defines Claude Code configuration
type Config ¶ added in v0.3.0
type Config struct {
// DefaultProfile is the profile to use when none is specified
DefaultProfile string `json:"default_profile"`
// LastUsed is the most recently used profile (for future use)
LastUsed string `json:"last_used,omitempty"`
// Version tracks config format for future migrations
Version int `json:"version"`
}
Config represents the global agent-deck configuration
func LoadConfig ¶ added in v0.3.0
LoadConfig loads the global configuration
type FileTracker ¶ added in v0.5.3
FileTracker tracks file state for incremental updates
type GlobalSearchIndex ¶ added in v0.5.3
type GlobalSearchIndex struct {
// contains filtered or unexported fields
}
GlobalSearchIndex manages the searchable session index
func NewGlobalSearchIndex ¶ added in v0.5.3
func NewGlobalSearchIndex(claudeDir string, config GlobalSearchSettings) (*GlobalSearchIndex, error)
NewGlobalSearchIndex creates a new search index
func (*GlobalSearchIndex) Close ¶ added in v0.5.3
func (idx *GlobalSearchIndex) Close()
Close shuts down the index
func (*GlobalSearchIndex) EntryCount ¶ added in v0.5.3
func (idx *GlobalSearchIndex) EntryCount() int
EntryCount returns the number of indexed entries
func (*GlobalSearchIndex) FuzzySearch ¶ added in v0.5.3
func (idx *GlobalSearchIndex) FuzzySearch(query string) []*SearchResult
FuzzySearch performs fuzzy matching with typo tolerance
func (*GlobalSearchIndex) GetTier ¶ added in v0.5.3
func (idx *GlobalSearchIndex) GetTier() SearchTier
GetTier returns the current search tier
func (*GlobalSearchIndex) IsLoading ¶ added in v0.5.3
func (idx *GlobalSearchIndex) IsLoading() bool
IsLoading returns true if the index is still loading
func (*GlobalSearchIndex) Search ¶ added in v0.5.3
func (idx *GlobalSearchIndex) Search(query string) []*SearchResult
Search performs a simple substring search
type GlobalSearchSettings ¶ added in v0.5.3
type GlobalSearchSettings struct {
// Enabled enables/disables global search feature (default: true when loaded via LoadUserConfig)
Enabled bool `toml:"enabled"`
// Tier controls search strategy: "auto", "instant", "balanced", "disabled"
// auto: Auto-detect based on data size (recommended)
// instant: Force full in-memory (fast, uses more RAM)
// balanced: Force LRU cache mode (slower, capped RAM)
// disabled: Disable global search entirely
Tier string `toml:"tier"`
// MemoryLimitMB caps memory usage for search index (default: 100)
// Only applies to balanced tier
MemoryLimitMB int `toml:"memory_limit_mb"`
// RecentDays limits search to sessions from last N days (0 = all)
// Reduces index size for users with long history (default: 90)
RecentDays int `toml:"recent_days"`
// IndexRateLimit limits files indexed per second during background indexing
// Lower = less CPU impact (default: 20)
IndexRateLimit int `toml:"index_rate_limit"`
}
GlobalSearchSettings defines global conversation search configuration
type Group ¶
type Group struct {
Name string
Path string // Full path like "projects" or "projects/devops"
Expanded bool
Sessions []*Instance
Order int
}
Group represents a group of sessions
type GroupData ¶
type GroupData struct {
Name string `json:"name"`
Path string `json:"path"`
Expanded bool `json:"expanded"`
Order int `json:"order"`
}
GroupData represents serializable group data
type GroupTree ¶
type GroupTree struct {
Groups map[string]*Group // path -> group
GroupList []*Group // Ordered list of groups
Expanded map[string]bool // Collapsed state persistence
}
GroupTree manages hierarchical session organization
func NewGroupTree ¶
NewGroupTree creates a new group tree from instances
func NewGroupTreeWithGroups ¶
NewGroupTreeWithGroups creates a group tree from instances and stored group data
func (*GroupTree) AddSession ¶
AddSession adds a session to the appropriate group
func (*GroupTree) CollapseGroup ¶
CollapseGroup collapses a group
func (*GroupTree) CreateGroup ¶
CreateGroup creates a new empty group
func (*GroupTree) CreateSubgroup ¶
CreateSubgroup creates a new empty group under a parent group
func (*GroupTree) DeleteGroup ¶
DeleteGroup deletes a group, all its subgroups, and moves all sessions to default
func (*GroupTree) ExpandGroup ¶
ExpandGroup expands a group
func (*GroupTree) ExpandGroupWithParents ¶
ExpandGroupWithParents expands a group and all its parent groups This ensures the group and its contents are visible in the flattened view
func (*GroupTree) GetAllInstances ¶
GetAllInstances returns all instances in order
func (*GroupTree) GetGroupNames ¶
GetGroupNames returns all group names for selection
func (*GroupTree) GetGroupPaths ¶
GetGroupPaths returns all group paths for selection
func (*GroupTree) GroupCount ¶
GroupCount returns total group count
func (*GroupTree) MoveGroupDown ¶
MoveGroupDown moves a group down in the order (only within siblings at same level)
func (*GroupTree) MoveGroupUp ¶
MoveGroupUp moves a group up in the order (only within siblings at same level)
func (*GroupTree) MoveSessionDown ¶
MoveSessionDown moves a session down within its group
func (*GroupTree) MoveSessionToGroup ¶
MoveSessionToGroup moves a session to a different group
func (*GroupTree) MoveSessionUp ¶
MoveSessionUp moves a session up within its group
func (*GroupTree) RemoveSession ¶
RemoveSession removes a session from its group
func (*GroupTree) RenameGroup ¶
RenameGroup renames a group and updates all subgroups
func (*GroupTree) SessionCount ¶
SessionCount returns total session count
func (*GroupTree) ShallowCopyForSave ¶ added in v0.7.0
ShallowCopyForSave creates a copy of the GroupTree that's safe to use from a goroutine for saving purposes. It deep copies the Group structs to prevent data races when the main thread modifies group fields (Name, Path, Expanded, Order) while a background goroutine reads them.
func (*GroupTree) SyncWithInstances ¶
SyncWithInstances updates the tree with a new set of instances while preserving existing group structure (including empty groups)
func (*GroupTree) ToggleGroup ¶
ToggleGroup toggles the expanded state of a group
type Instance ¶
type Instance struct {
ID string `json:"id"`
Title string `json:"title"`
ProjectPath string `json:"project_path"`
GroupPath string `json:"group_path"` // e.g., "projects/devops"
ParentSessionID string `json:"parent_session_id,omitempty"` // Links to parent session (makes this a sub-session)
Command string `json:"command"`
Tool string `json:"tool"`
Status Status `json:"status"`
CreatedAt time.Time `json:"created_at"`
LastAccessedAt time.Time `json:"last_accessed_at,omitempty"` // When user last attached
// Claude Code integration
ClaudeSessionID string `json:"claude_session_id,omitempty"`
ClaudeDetectedAt time.Time `json:"claude_detected_at,omitempty"`
// MCP tracking - which MCPs were loaded when session started/restarted
// Used to detect pending MCPs (added after session start) and stale MCPs (removed but still running)
LoadedMCPNames []string `json:"loaded_mcp_names,omitempty"`
// contains filtered or unexported fields
}
Instance represents a single agent/shell session
func DiscoverExistingTmuxSessions ¶
DiscoverExistingTmuxSessions finds all tmux sessions and converts them to instances
func FilterByQuery ¶
FilterByQuery filters sessions by title, project path, tool, or status Supports status filters: "waiting", "running", "idle", "error"
func NewInstance ¶
NewInstance creates a new session instance
func NewInstanceWithGroup ¶
NewInstanceWithGroup creates a new session instance with explicit group
func NewInstanceWithGroupAndTool ¶ added in v0.4.1
NewInstanceWithGroupAndTool creates a new session with explicit group and tool
func NewInstanceWithTool ¶ added in v0.4.1
NewInstanceWithTool creates a new session with tool-specific initialization
func (*Instance) CanFork ¶ added in v0.4.1
CanFork returns true if this session can be forked (has recent Claude session)
func (*Instance) CanRestart ¶ added in v0.4.1
CanRestart returns true if the session can be restarted For Claude sessions with known ID: can always restart (interrupt and resume) For other sessions: only if dead/error state
func (*Instance) CaptureLoadedMCPs ¶ added in v0.5.3
func (i *Instance) CaptureLoadedMCPs()
CaptureLoadedMCPs captures the current MCP names as the "loaded" state This should be called when a session starts or restarts, so we can track which MCPs are actually loaded in the running Claude session vs just configured
func (*Instance) ClearParent ¶ added in v0.7.0
func (inst *Instance) ClearParent()
ClearParent removes the parent session link
func (*Instance) CreateForkedInstance ¶ added in v0.4.1
CreateForkedInstance creates a new Instance configured for forking
func (*Instance) Fork ¶ added in v0.4.1
Fork returns the command to create a forked Claude session Uses capture-resume pattern: starts fork in print mode to get new session ID, stores in tmux environment, then resumes interactively
func (*Instance) GetActualWorkDir ¶ added in v0.4.1
GetActualWorkDir returns the actual working directory from tmux, or falls back to ProjectPath
func (*Instance) GetLastActivityTime ¶ added in v0.5.6
GetLastActivityTime returns when the session was last active (content changed) Returns CreatedAt if no activity has been tracked yet
func (*Instance) GetLastResponse ¶ added in v0.7.0
func (i *Instance) GetLastResponse() (*ResponseOutput, error)
GetLastResponse returns the last assistant response from the session For Claude: Parses the JSONL file for the last assistant message For Gemini/Codex: Attempts to parse terminal output
func (*Instance) GetMCPInfo ¶ added in v0.5.3
GetMCPInfo returns MCP server information for this session Returns nil if not a Claude session
func (*Instance) GetSessionIDFromTmux ¶ added in v0.5.0
GetSessionIDFromTmux reads Claude session ID from tmux environment This is the primary method for sessions started with the capture-resume pattern
func (*Instance) GetTmuxSession ¶
GetTmuxSession returns the tmux session object
func (*Instance) HasUpdated ¶
HasUpdated checks if there's new output since last check
func (*Instance) IsSubSession ¶ added in v0.7.0
IsSubSession returns true if this session has a parent
func (*Instance) MarkAccessed ¶ added in v0.5.3
func (inst *Instance) MarkAccessed()
MarkAccessed updates the LastAccessedAt timestamp to now
func (*Instance) PreviewFull ¶
PreviewFull returns all terminal output
func (*Instance) Restart ¶ added in v0.4.1
Restart restarts the Claude session For Claude sessions with known ID: sends Ctrl+C twice and resume command to existing session For dead sessions or unknown ID: recreates the tmux session
func (*Instance) StartWithMessage ¶ added in v0.6.2
StartWithMessage starts the session and sends an initial message when ready The message is sent synchronously after detecting the agent's prompt This approach is more reliable than embedding send logic in the tmux command Works for Claude, Gemini, OpenCode, and other agents
func (*Instance) UpdateClaudeSession ¶ added in v0.4.1
UpdateClaudeSession updates the Claude session ID using detection Priority: 1) tmux environment (for sessions we started), 2) file scanning (legacy/imported) excludeIDs contains session IDs already claimed by other instances Pass nil to skip deduplication (when called from UpdateStatus)
func (*Instance) UpdateStatus ¶
UpdateStatus updates the session status by checking tmux
func (*Instance) WaitForClaudeSession ¶ added in v0.4.1
WaitForClaudeSession waits for Claude to create a session file (for forked sessions) Returns the detected session ID or empty string after timeout Uses FindSessionForInstance with timestamp filtering to ensure we only detect session files created AFTER this instance started (not parent's pre-existing file)
func (*Instance) WaitForClaudeSessionWithExclude ¶ added in v0.5.0
func (i *Instance) WaitForClaudeSessionWithExclude(maxWait time.Duration, excludeIDs map[string]bool) string
WaitForClaudeSessionWithExclude waits for Claude to create a session file with exclusion list This is more robust than WaitForClaudeSession as it explicitly excludes known session IDs Use this when forking to ensure the fork's new session is detected, not an existing one
type InstanceData ¶
type InstanceData struct {
ID string `json:"id"`
Title string `json:"title"`
ProjectPath string `json:"project_path"`
GroupPath string `json:"group_path"`
ParentSessionID string `json:"parent_session_id,omitempty"` // Links to parent session (sub-session support)
Command string `json:"command"`
Tool string `json:"tool"`
Status Status `json:"status"`
CreatedAt time.Time `json:"created_at"`
LastAccessedAt time.Time `json:"last_accessed_at,omitempty"`
TmuxSession string `json:"tmux_session"`
// Claude session (persisted for resume after app restart)
ClaudeSessionID string `json:"claude_session_id,omitempty"`
ClaudeDetectedAt time.Time `json:"claude_detected_at,omitempty"`
// MCP tracking (persisted for sync status display)
LoadedMCPNames []string `json:"loaded_mcp_names,omitempty"`
}
InstanceData represents the serializable session data
type Item ¶
type Item struct {
Type ItemType
Group *Group
Session *Instance
Level int // Indentation level (0 for root groups, 1 for sessions)
Path string // Group path for this item
IsLastInGroup bool // True if this is the last session in its group (for tree rendering)
RootGroupNum int // Pre-computed root group number for hotkey display (1-9, 0 if not a root group)
IsSubSession bool // True if this session has a parent session
IsLastSubSession bool // True if this is the last sub-session of its parent (for tree rendering)
}
Item represents a single item in the flattened group tree view
type LocalMCP ¶ added in v0.6.1
type LocalMCP struct {
Name string // MCP name
SourcePath string // Directory containing the .mcp.json file
}
LocalMCP represents an MCP defined in a local .mcp.json file
type LogSettings ¶ added in v0.5.3
type LogSettings struct {
// MaxSizeMB is the maximum size in MB before a log file is truncated
// When a log exceeds this size, it keeps only the last MaxLines lines
// Default: 10 (10MB)
MaxSizeMB int `toml:"max_size_mb"`
// MaxLines is the number of lines to keep when truncating
// Default: 10000
MaxLines int `toml:"max_lines"`
// RemoveOrphans removes log files for sessions that no longer exist
// Default: true
RemoveOrphans bool `toml:"remove_orphans"`
}
LogSettings defines log file management configuration
func GetLogSettings ¶ added in v0.5.3
func GetLogSettings() LogSettings
GetLogSettings returns log management settings with defaults applied
type MCPDef ¶ added in v0.5.3
type MCPDef struct {
// Command is the executable to run (e.g., "npx", "docker", "node")
Command string `toml:"command"`
// Args are command-line arguments
Args []string `toml:"args"`
// Env is optional environment variables
Env map[string]string `toml:"env"`
// Description is optional help text shown in the MCP Manager
Description string `toml:"description"`
}
MCPDef defines an MCP server configuration for the MCP Manager
type MCPInfo ¶ added in v0.5.3
type MCPInfo struct {
Global []string // From CLAUDE_CONFIG_DIR/.claude.json mcpServers
Project []string // From CLAUDE_CONFIG_DIR/.claude.json projects[path].mcpServers
LocalMCPs []LocalMCP // From .mcp.json files (walks up parent directories)
}
MCPInfo contains MCP server information for a session
func GetMCPInfo ¶ added in v0.5.3
GetMCPInfo retrieves MCP server information for a project path (cached) It reads from three sources: 1. Global MCPs: CLAUDE_CONFIG_DIR/.claude.json → mcpServers 2. Project MCPs: CLAUDE_CONFIG_DIR/.claude.json → projects[projectPath].mcpServers 3. Local MCPs: {projectPath}/.mcp.json → mcpServers
func (*MCPInfo) AllNames ¶ added in v0.5.3
AllNames returns a deduplicated, sorted list of all MCP names across all sources Used for capturing loaded MCPs at session start for sync tracking
type MCPMode ¶ added in v0.5.3
type MCPMode int
MCPMode indicates how MCP enabling/disabling is configured
func GetMCPMode ¶ added in v0.5.3
GetMCPMode determines the MCP configuration mode for a project
type MCPPoolSettings ¶ added in v0.6.2
type MCPPoolSettings struct {
// Enabled enables HTTP pool mode (default: false)
Enabled bool `toml:"enabled"`
// AutoStart starts pool when agent-deck launches (default: true)
AutoStart bool `toml:"auto_start"`
// PortStart is the first port in the pool range (default: 8001)
PortStart int `toml:"port_start"`
// PortEnd is the last port in the pool range (default: 8050)
PortEnd int `toml:"port_end"`
// StartOnDemand starts MCPs lazily on first attach (default: false)
StartOnDemand bool `toml:"start_on_demand"`
// ShutdownOnExit stops HTTP servers when agent-deck quits (default: true)
ShutdownOnExit bool `toml:"shutdown_on_exit"`
// PoolMCPs is the list of MCPs to run in pool mode
// Empty = auto-detect common MCPs (memory, exa, firecrawl, etc.)
PoolMCPs []string `toml:"pool_mcps"`
// FallbackStdio uses stdio for MCPs without socket support (default: true)
FallbackStdio bool `toml:"fallback_to_stdio"`
// ShowStatus shows pool status in TUI (default: true)
ShowStatus bool `toml:"show_pool_status"`
// PoolAll pools all MCPs by default (default: false)
PoolAll bool `toml:"pool_all"`
// ExcludeMCPs excludes specific MCPs from pool when pool_all = true
ExcludeMCPs []string `toml:"exclude_mcps"`
}
MCPPoolSettings defines HTTP MCP pool configuration
type MCPServer ¶ added in v0.5.3
MCPServer represents an MCP with its enabled state
func GetLocalMCPState ¶ added in v0.5.3
GetLocalMCPState returns Local MCPs with their enabled state
type MCPServerConfig ¶ added in v0.5.3
type MCPServerConfig struct {
Type string `json:"type,omitempty"`
Command string `json:"command,omitempty"`
Args []string `json:"args,omitempty"`
Env map[string]string `json:"env,omitempty"`
URL string `json:"url,omitempty"` // For HTTP transport
}
MCPServerConfig represents an MCP server configuration (Claude's format)
type MatchRange ¶ added in v0.5.3
MatchRange represents a match position in content
type MigrationResult ¶ added in v0.3.0
type MigrationResult struct {
Migrated bool // True if migration was performed
ProfilePath string // Path to the migrated profile
SessionCount int // Number of sessions migrated
Message string // Human-readable message
}
MigrationResult contains information about the migration outcome
func MigrateToProfiles ¶ added in v0.3.0
func MigrateToProfiles() (*MigrationResult, error)
MigrateToProfiles migrates from the old single-file layout to the profiles layout. This is safe to call multiple times - it will only migrate once.
Old layout:
~/.agent-deck/sessions.json ~/.agent-deck/sessions.json.bak ~/.agent-deck/sessions.json.bak.1 ~/.agent-deck/sessions.json.bak.2
New layout:
~/.agent-deck/config.json ~/.agent-deck/profiles/default/sessions.json ~/.agent-deck/profiles/default/sessions.json.bak ~/.agent-deck/profiles/default/sessions.json.bak.1 ~/.agent-deck/profiles/default/sessions.json.bak.2 ~/.agent-deck/logs/ (unchanged)
type ProjectMCPSettings ¶ added in v0.5.3
type ProjectMCPSettings struct {
EnableAllProjectMcpServers bool `json:"enableAllProjectMcpServers,omitempty"`
EnabledMcpjsonServers []string `json:"enabledMcpjsonServers,omitempty"`
DisabledMcpjsonServers []string `json:"disabledMcpjsonServers,omitempty"`
}
ProjectMCPSettings represents .claude/settings.local.json
type ResponseOutput ¶ added in v0.7.0
type ResponseOutput struct {
Tool string `json:"tool"` // Tool type (claude, gemini, etc.)
Role string `json:"role"` // Always "assistant" for now
Content string `json:"content"` // The actual response text
Timestamp string `json:"timestamp,omitempty"` // When the response was generated (Claude only)
SessionID string `json:"session_id,omitempty"` // Claude session ID (if available)
}
ResponseOutput represents a parsed response from an agent session
type SearchEntry ¶ added in v0.5.3
type SearchEntry struct {
SessionID string // Claude session UUID
FilePath string // Path to .jsonl file
CWD string // Project working directory
Content string // Full conversation content (original case)
ContentLower string // Lowercased for search
Summary string // First user message or summary
ModTime time.Time // File modification time
FileSize int64 // File size in bytes
}
SearchEntry represents a searchable Claude session
func (*SearchEntry) GetSnippet ¶ added in v0.5.3
func (e *SearchEntry) GetSnippet(query string, windowSize int) string
GetSnippet extracts a context window around the first match Uses rune-based indexing to safely handle UTF-8 content
func (*SearchEntry) Match ¶ added in v0.5.3
func (e *SearchEntry) Match(query string) []MatchRange
Match searches for query in entry content (case-insensitive) Returns match positions for highlighting
type SearchResult ¶ added in v0.5.3
type SearchResult struct {
Entry *SearchEntry
Matches []MatchRange
Score int
Snippet string
}
SearchResult represents a search result with match info
type SearchTier ¶ added in v0.5.3
type SearchTier int
SearchTier represents the search strategy tier
const ( TierInstant SearchTier = iota // < 100MB, full in-memory TierBalanced // 100MB-500MB, LRU cache )
func DetectTier ¶ added in v0.5.3
func DetectTier(totalSize int64) SearchTier
DetectTier determines the appropriate search tier based on data size
type Storage ¶
type Storage struct {
// contains filtered or unexported fields
}
Storage handles persistence of session data Thread-safe with mutex protection for concurrent access
func NewStorage ¶
NewStorage creates a new storage instance using the default profile. It automatically runs migration from old layout if needed.
func NewStorageWithProfile ¶ added in v0.3.0
NewStorageWithProfile creates a storage instance for a specific profile. If profile is empty, uses the effective profile (from env var or config). Automatically runs migration from old layout if needed.
func (*Storage) GetUpdatedAt ¶ added in v0.6.1
GetUpdatedAt returns the last modification timestamp of the storage file This is read from the UpdatedAt field in the JSON file. Returns an error if the file doesn't exist or can't be read.
func (*Storage) LoadWithGroups ¶
LoadWithGroups reads instances and groups from JSON file Automatically recovers from backup if main file is corrupted
func (*Storage) Save ¶
Save persists instances to JSON file DEPRECATED: Use SaveWithGroups to ensure groups are not lost
func (*Storage) SaveWithGroups ¶
SaveWithGroups persists instances and groups to JSON file Uses atomic write pattern with: - Mutex for thread safety - Rolling backups (3 generations) - fsync for durability - Data validation
type StorageData ¶
type StorageData struct {
Instances []*InstanceData `json:"instances"`
Groups []*GroupData `json:"groups,omitempty"` // Persist empty groups
UpdatedAt time.Time `json:"updated_at"`
}
StorageData represents the JSON structure for persistence
type ToolDef ¶ added in v0.3.0
type ToolDef struct {
// Command is the shell command to run
Command string `toml:"command"`
// Icon is the emoji/symbol to display
Icon string `toml:"icon"`
// BusyPatterns are strings that indicate the tool is busy
BusyPatterns []string `toml:"busy_patterns"`
}
ToolDef defines a custom AI tool
func GetToolDef ¶ added in v0.3.0
GetToolDef returns a tool definition from user config Returns nil if tool is not defined
type UserConfig ¶ added in v0.3.0
type UserConfig struct {
// DefaultTool is the pre-selected AI tool when creating new sessions
// Valid values: "claude", "gemini", "opencode", "codex", or any custom tool name
// If empty or invalid, defaults to "shell" (no pre-selection)
DefaultTool string `toml:"default_tool"`
// Tools defines custom AI tool configurations
Tools map[string]ToolDef `toml:"tools"`
// MCPs defines available MCP servers for the MCP Manager
// These can be attached/detached per-project via the MCP Manager (M key)
MCPs map[string]MCPDef `toml:"mcps"`
// Claude defines Claude Code integration settings
Claude ClaudeSettings `toml:"claude"`
// GlobalSearch defines global conversation search settings
GlobalSearch GlobalSearchSettings `toml:"global_search"`
// Logs defines session log management settings
Logs LogSettings `toml:"logs"`
// MCPPool defines HTTP MCP pool settings for shared MCP servers
MCPPool MCPPoolSettings `toml:"mcp_pool"`
}
UserConfig represents user-facing configuration in TOML format
func LoadUserConfig ¶ added in v0.3.0
func LoadUserConfig() (*UserConfig, error)
LoadUserConfig loads the user configuration from TOML file Returns cached config after first load
func ReloadUserConfig ¶ added in v0.3.0
func ReloadUserConfig() (*UserConfig, error)
ReloadUserConfig forces a reload of the user config