Terminal

Extensions can create, manage, and interact with terminal sessions.

TerminalManager

private val terminalManager: TerminalManager by plugin()

The TerminalManager exposes three subsystems:

Property	Type	Description
sessionManager	TerminalSessionManager	Create and manage sessions
sessionBinder	TerminalSessionBinder	Bind/unbind the terminal service (for internal use only)

TerminalSessionManager

Managing sessions

// Get all sessions
val sessions: List<TerminalSessionEntry> = sessionManager.sessions.value

// Get current session
val current: TerminalSessionEntry? = sessionManager.currentSession.value
val currentId: Uuid? = sessionManager.currentSessionId.value

// Create a new session
val session = sessionManager.newSession(client = terminalClient)

// Create or get an existing session
val session = sessionManager.getOrCreateSession(id, client)

// Switch to a specific session
sessionManager.switchTo(sessionId)

// Terminate sessions
sessionManager.terminate(sessionId)
sessionManager.terminateCurrentSession()
sessionManager.terminateAll()

TerminalSessionEntry

data class TerminalSessionEntry(
    val id: Uuid,
    val session: TerminalSession
)

Terminal paths

Paths.rootFs       // dataDir/rootfs — the root filesystem
Paths.home         // filesDir/home — user home directory
Paths.projects     // home/projects — projects directory
Paths.versionFile  // rootFs/.bootstrap-version