Directories
¶
| Path | Synopsis |
|---|---|
|
Package api holds aimux's published API contracts, embedded so the server can serve them and tests can check the server against them.
|
Package api holds aimux's published API contracts, embedded so the server can serve them and tests can check the server against them. |
|
clients
|
|
|
web
Package webclient is a browser client for aimux's remote API: a phone web app served at /app/ by `aimux remote serve`.
|
Package webclient is a browser client for aimux's remote API: a phone web app served at /app/ by `aimux remote serve`. |
|
cmd
|
|
|
aimux
command
|
|
|
mcp
command
|
|
|
internal
|
|
|
acprun
Package acprun continues an existing agent session through an ACP adapter (claude-agent-acp, codex-acp): it starts the adapter, loads the session, sends prompts, streams updates as numbered events and relays permission requests.
|
Package acprun continues an existing agent session through an ACP adapter (claude-agent-acp, codex-acp): it starts the adapter, loads the session, sends prompts, streams updates as numbered events and relays permission requests. |
|
catalog
Package catalog is this machine's session catalog: every registered provider's sessions joined with their shown title, visibility, provider and live state.
|
Package catalog is this machine's session catalog: every registered provider's sessions joined with their shown title, visibility, provider and live state. |
|
clipboard
Package clipboard provides cross-platform text clipboard operations.
|
Package clipboard provides cross-platform text clipboard operations. |
|
controller
Package controller provides UI-agnostic business logic for aimux.
|
Package controller provides UI-agnostic business logic for aimux. |
|
folders
Package folders gives every session path one folder identity: the git repository, the linked worktree and the subfolder it runs in.
|
Package folders gives every session path one folder identity: the git repository, the linked worktree and the subfolder it runs in. |
|
gitinfo
Package gitinfo is the one place aimux asks git about a folder: its top-level and common dir, its origin and its branch.
|
Package gitinfo is the one place aimux asks git about a folder: its top-level and common dir, its origin and its branch. |
|
gitremote
Package gitremote finds the web address of a folder's git repository, so clients can link commits, issues and files in a reply.
|
Package gitremote finds the web address of a folder's git repository, so clients can link commits, issues and files in a reply. |
|
harness
Package harness holds the types shared by the core packages and the harness-specific code behind them, so that terminput never imports provider and provider never imports terminput.
|
Package harness holds the types shared by the core packages and the harness-specific code behind them, so that terminput never imports provider and provider never imports terminput. |
|
harness/claude
Package claude is Claude Code's harness.Composer: it parses the screen Claude Code draws in a terminal (input box, permission prompt, working line, paste marker) and knows its process names.
|
Package claude is Claude Code's harness.Composer: it parses the screen Claude Code draws in a terminal (input box, permission prompt, working line, paste marker) and knows its process names. |
|
history
Package history discovers and manages past AI agent sessions.
|
Package history discovers and manages past AI agent sessions. |
|
jsonedit
Package jsonedit edits one top-level key of a JSON config file that another program (Claude Code) also rewrites: atomically, verified by reading back, every other key byte-identical, and backs such files up with rotation.
|
Package jsonedit edits one top-level key of a JSON config file that another program (Claude Code) also rewrites: atomically, verified by reading back, every other key byte-identical, and backs such files up with rotation. |
|
jsonl
Package jsonl reads agent session files line by line.
|
Package jsonl reads agent session files line by line. |
|
llm
Package llm is aimux's one model client: the Anthropic Messages API when an API key is set, else `claude -p` in safe mode with the owner's Claude Code login; the short model names config accepts; and a usage line in ~/.aimux/data/usage.jsonl for every call, labelled by the caller ("naming", "insight").
|
Package llm is aimux's one model client: the Anthropic Messages API when an API key is set, else `claude -p` in safe mode with the owner's Claude Code login; the short model names config accepts; and a usage line in ~/.aimux/data/usage.jsonl for every call, labelled by the caller ("naming", "insight"). |
|
mcpproxy
Install (install.go) moves Claude Code's stdio MCP servers behind the proxy and back, one mcpServers entry per server under its own name, so tool names and every permission rule stay as they are.
|
Install (install.go) moves Claude Code's stdio MCP servers behind the proxy and back, one mcpServers entry per server under its own name, so tool names and every permission rule stay as they are. |
|
mcpserver
Package mcpserver provides the MCP server for remote agent orchestration.
|
Package mcpserver provides the MCP server for remote agent orchestration. |
|
netguard
Package netguard keeps aimux's local HTTP endpoints reachable only from this machine: no DNS rebinding and no requests from other web sites.
|
Package netguard keeps aimux's local HTTP endpoints reachable only from this machine: no DNS rebinding and no requests from other web sites. |
|
push
Package push tells a person's devices that an agent is waiting for them, so a permission request reaches the lock screen while no client is open.
|
Package push tells a person's devices that an agent is waiting for them, so a permission request reaches the lock screen while no client is open. |
|
remoteapi
Package remoteapi is aimux's API for clients on other devices (a phone, another laptop): list sessions, follow them, and continue idle ones.
|
Package remoteapi is aimux's API for clients on other devices (a phone, another laptop): list sessions, follow them, and continue idle ones. |
|
remoteapi/chatqueue
Package chatqueue holds each session's queue of messages waiting to be sent from the phone, persisted on the Mac, and the rules for how an item moves from waiting to sent.
|
Package chatqueue holds each session's queue of messages waiting to be sent from the phone, persisted on the Mac, and the rules for how an item moves from waiting to sent. |
|
remoteapi/devicelogin
Package devicelogin keeps the devices paired with the remote API and the pending pairing code.
|
Package devicelogin keeps the devices paired with the remote API and the pending pairing code. |
|
remoteapp
Package remoteapp composes `aimux remote serve`: it builds the services the remote API needs (provider registry, live sessions, chat manager and router, broker, search, terminal input, chat queue and dispatcher, namer, folders, Mac layout, waiting tracker, push, device login), runs their background jobs and shuts them down in order.
|
Package remoteapp composes `aimux remote serve`: it builds the services the remote API needs (provider registry, live sessions, chat manager and router, broker, search, terminal input, chat queue and dispatcher, namer, folders, Mac layout, waiting tracker, push, device login), runs their background jobs and shuts them down in order. |
|
runtime
Package runtime defines the interface for agent execution environments.
|
Package runtime defines the interface for agent execution environments. |
|
search
Package search builds a persistent, ranked index over Claude Code session transcripts: full-text (SQLite FTS5, BM25) plus optional embeddings for semantic ranking.
|
Package search builds a persistent, ranked index over Claude Code session transcripts: full-text (SQLite FTS5, BM25) plus optional embeddings for semantic ranking. |
|
sessionmcp
Package sessionmcp serves Claude Code session search and resume tools over MCP, on top of the internal/search index.
|
Package sessionmcp serves Claude Code session search and resume tools over MCP, on top of the internal/search index. |
|
sessions
Package sessions provides interactive session picking via fzf or bubbletea.
|
Package sessions provides interactive session picking via fzf or bubbletea. |
|
sessionstate
Package sessionstate answers one question for every surface: what is this session doing right now.
|
Package sessionstate answers one question for every surface: what is this session doing right now. |
|
task
Package task defines the unified Task model and loaders for both Redis (K8s agents) and local filesystem (Claude Code teams).
|
Package task defines the unified Task model and loaders for both Redis (K8s agents) and local filesystem (Claude Code teams). |
|
terminput
Package terminput types text and keys into Claude Code sessions that are open in a terminal, after checking what the screen shows.
|
Package terminput types text and keys into Claude Code sessions that are open in a terminal, after checking what the screen shows. |
|
terminput/iterm2
Package iterm2 is the terminput driver for iTerm2.
|
Package iterm2 is the terminput driver for iTerm2. |
|
trace
Package trace defines shared types for conversation trace parsing.
|
Package trace defines shared types for conversation trace parsing. |
|
waiting
Package waiting records which Claude Code sessions are waiting for the owner's permission.
|
Package waiting records which Claude Code sessions are waiting for the owner's permission. |
|
pkg
|
|
|
rediskeys
Package rediskeys defines all Redis key patterns for the k8s-agents system.
|
Package rediskeys defines all Redis key patterns for the k8s-agents system. |
|
test
|
|
|
e2e/discovery/fakeagent
command
Command fakeagent stands in for the claude binary when recording the README demo.
|
Command fakeagent stands in for the claude binary when recording the README demo. |
Click to show internal directories.
Click to hide internal directories.