sessions

package

v0.0.40 Latest Latest Go to latest Published: Jul 5, 2026 License: Apache-2.0 Imports: 8 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/diegosz/apex_process_ape

Links

Open Source Insights

Documentation ¶

Rendered for

Overview ¶

Package sessions maintains ~/.ape/registry.json — the cross-project list of live `ape chat` / `ape pipeline` (web mode) invocations so users can list, prune, and reopen them. PLAN-5 / C5.

Index ¶

func DefaultPath() string
func Deregister(path string, pid int) error
func Register(path string, s Session) error
type Session
- func List(path string) ([]Session, error)
- func Prune(path string) ([]Session, error)

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

func DefaultPath ¶

func DefaultPath() string

DefaultPath returns ~/.ape/registry.json. Falls back to a temp-directory path if $HOME is unset (best-effort — the registry is non-load-bearing, so a missing home dir should not crash ape).

func Deregister ¶

func Deregister(path string, pid int) error

Deregister removes the entry whose PID matches s.PID. No-op if not found (best-effort cleanup; we want shutdown to always succeed).

func Register ¶

func Register(path string, s Session) error

Register appends s to the registry at path. Acquires an exclusive flock for the write so concurrent ape invocations cannot interleave. Creates the parent directory if missing.

Types ¶

type Session ¶

type Session struct {
	PID       int       `json:"pid"`
	CWD       string    `json:"cwd"`
	Command   string    `json:"command"`
	Port      int       `json:"port"`
	URL       string    `json:"url"`
	StartedAt time.Time `json:"started_at"`
}

Session is one row in the registry.

func List ¶

func List(path string) ([]Session, error)

List reads the registry without taking the write lock or pruning. Useful for `ape sessions` (which prunes first via Prune).

func Prune ¶

func Prune(path string) ([]Session, error)

Prune drops rows whose PID is no longer running. Returns the rows that survived. Called by every startup and by `ape sessions prune`.

Source Files ¶

View all Source files

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL