@rse/ase 2.0.3 → 2.0.4

package/dst/man/ase-service-status.1

@@ -1,46 +0,0 @@
-.TH "ASE-SERVICE-STATUS" "1" "October 2026" "2.0.3" "Agentic Software Engineering (ASE)"
-.SH "NAME"
-\fBase-service-status\fR - Report Whether the Background Service Is Running
-.SH "SYNOPSIS"
-.P
-\fBase service status\fR \[lB]\fB-h\fR|\fB--help\fR\[rB]
-.SH "DESCRIPTION"
-.P
-\fBase service status\fR reports whether the per-project background service of \fIASE\fR (see \fBase-service\fR(1)) is running. It probes the port persisted in \fB.ase/service.yaml\fR via an HTTP \fBOPTIONS /\fR request and verifies that the responding service belongs to the current project (by its project id). It prints one of the following lines on standard output:
-.RS 0
-.IP \(bu 4
-\fBservice: running on port\fR \fIport\fR \fB(uptime:\fR \fIduration\fR\fB)\fR: A service of this project is running.
-.IP \(bu 4
-\fBservice: not running (no port configured)\fR: No port is persisted in \fB.ase/service.yaml\fR.
-.IP \(bu 4
-\fBservice: not running (port\fR \fIport\fR \fBnot responding)\fR: Nothing listens on the persisted port.
-.IP \(bu 4
-\fBservice: not running (port\fR \fIport\fR \fBin use by foreign service)\fR: The persisted port is answered by something else, e.g., the service of another project.
-.RE 0
-.SH "OPTIONS"
-.RS 0
-.IP \(bu 4
-\[lB]\fB-h\fR|\fB--help\fR\[rB]: Show usage information and exit.
-.RE 0
-.SH "FILES"
-.RS 0
-.IP \(bu 4
-\fB.ase/service.yaml\fR: The persisted port of the service.
-.RE 0
-.SH "EXIT STATUS"
-.P
-\fB0\fR if the service of the project is running, else \fB1\fR.
-.SH "EXAMPLES"
-.P
-.RS 2
-.nf
-$ ase service status
-service: running on port 42817 (uptime: 12 minutes 3.4 seconds)
-.fi
-.RE
-.SH "SEE ALSO"
-.P
-\fBase\fR(1), \fBase-service\fR(1), \fBase-service-start\fR(1), \fBase-service-stop\fR(1).
-.SH "AUTHOR"
-.P
-Dr. Ralf S. Engelschall \fI\(larse@engelschall.com\(ra\fR

package/dst/man/ase-service-stop.1

@@ -1,37 +0,0 @@
-.TH "ASE-SERVICE-STOP" "1" "October 2026" "2.0.3" "Agentic Software Engineering (ASE)"
-.SH "NAME"
-\fBase-service-stop\fR - Stop the Background Service
-.SH "SYNOPSIS"
-.P
-\fBase service stop\fR \[lB]\fB-h\fR|\fB--help\fR\[rB]
-.SH "DESCRIPTION"
-.P
-\fBase service stop\fR stops the per-project background service of \fIASE\fR (see \fBase-service\fR(1)) via an HTTP \fBPOST /stop\fR request to the port persisted in \fB.ase/service.yaml\fR, and removes the persisted port (and the file, if it becomes empty). This also stops a service running in the foreground via \fBase service start --foreground\fR. On stop, the service persists the journal of its AI usage windows, so no usage is lost.
-.P
-If no port is persisted, or nothing listens on the persisted port, an informational message is logged, a stale port is removed, and the command exits with status \fB0\fR. If the persisted port is answered by a foreign service (e.g., the service of another project), it is left alone and the command exits with status \fB1\fR.
-.SH "OPTIONS"
-.RS 0
-.IP \(bu 4
-\[lB]\fB-h\fR|\fB--help\fR\[rB]: Show usage information and exit.
-.RE 0
-.SH "FILES"
-.RS 0
-.IP \(bu 4
-\fB.ase/service.yaml\fR: The persisted port of the service, cleared on stop.
-.RE 0
-.SH "EXIT STATUS"
-.P
-\fB0\fR if the service was stopped or was not running, \fB1\fR if the port is in use by a foreign service or the stop request failed.
-.SH "EXAMPLES"
-.P
-.RS 2
-.nf
-$ ase service stop
-.fi
-.RE
-.SH "SEE ALSO"
-.P
-\fBase\fR(1), \fBase-service\fR(1), \fBase-service-start\fR(1), \fBase-service-status\fR(1).
-.SH "AUTHOR"
-.P
-Dr. Ralf S. Engelschall \fI\(larse@engelschall.com\(ra\fR

package/dst/man/ase-service.1

@@ -1,85 +0,0 @@
-.TH "ASE-SERVICE" "1" "October 2026" "2.0.3" "Agentic Software Engineering (ASE)"
-.SH "NAME"
-\fBase-service\fR - Manage the Per-Project Background Service
-.SH "SYNOPSIS"
-.P
-\fBase service\fR \[lB]\fB-h\fR|\fB--help\fR\[rB] \fIcommand\fR \[lB]\fIoptions\fR \[lB]...\[rB]\[rB] \[lB]\fIargs\fR \[lB]...\[rB]\[rB]
-.P
-\fBase service start\fR \[lB]\fB-f\fR|\fB--foreground\fR\[rB]
-.P
-\fBase service status\fR
-.P
-\fBase service send\fR \fIcmd\fR
-.P
-\fBase service log\fR \[lB]\fB-f\fR|\fB--follow\fR\[rB] \[lB]\fB-n\fR|\fB--lines\fR \fIn\fR\[rB]
-.P
-\fBase service stop\fR
-.SH "DESCRIPTION"
-.P
-\fBase service\fR manages the per-project background HTTP service of \fIASE\fR. The service is bound to \fB127.0.0.1\fR on the preferred port \fBproject.service.port\fR, if configured and available, else on a random port out of the range \fB42000\fR..\fB44000\fR, which is persisted in \fB.ase/service.yaml\fR of the project, and logs into \fB.ase/service.log\fR. It is identified by the id of the project (\fBproject.id\fR, else derived from the project root), so a port answered by the service of another project counts as a \fIforeign\fR service.
-.P
-The service provides:
-.RS 0
-.IP \(bu 4
-the MCP endpoint \fB/mcp\fR (Streamable HTTP), serving the \fBase_*\fR MCP tools of the skills, bridged into the agent tool via \fBase-mcp\fR(1), which auto-starts the service on demand,
-.IP \(bu 4
-the command endpoint \fB/command\fR (see \fBase-service-send\fR(1)) and the stop endpoint \fB/stop\fR,
-.IP \(bu 4
-the endpoints \fB/usage/*\fR of the AI usage accounting of the task assignments (see \fBase-task-assign\fR(1)), plus, while \fBtelemetry.enabled\fR is \fBtrue\fR, the attempt to hold the per-user OTLP ingress on \fB127.0.0.1:\fR\fIport\fR (\fBtelemetry.service.port\fR, default \fB44318\fR), routing the received records to the service of the project owning the session (see \fBase-setup-telemetry\fR(1)),
-.IP \(bu 4
-the web task board of \fBase task board --web\fR (see \fBase-task-board\fR(1)).
-.RE 0
-.P
-The service accepts requests with a loopback \fBHost\fR header only, to defeat DNS rebinding attacks from browser pages. A detached service stops itself after 30 minutes without any request, but never while a request is in flight or while it holds open AI usage windows.
-.P
-Without a \fIcommand\fR, the usage information is shown and the command exits with status \fB1\fR.
-.SH "OPTIONS"
-.RS 0
-.IP \(bu 4
-\[lB]\fB-h\fR|\fB--help\fR\[rB]: Show usage information and exit.
-.RE 0
-.SH "COMMANDS"
-.RS 0
-.IP \(bu 4
-\fBstart\fR \[lB]\fB-f\fR|\fB--foreground\fR\[rB]: Start the service in the background (or run it in the foreground). See \fBase-service-start\fR(1).
-.IP \(bu 4
-\fBstatus\fR: Report whether the service is running. See \fBase-service-status\fR(1).
-.IP \(bu 4
-\fBsend\fR \fIcmd\fR: Send a command to the service. See \fBase-service-send\fR(1).
-.IP \(bu 4
-\fBlog\fR \[lB]\fB-f\fR|\fB--follow\fR\[rB] \[lB]\fB-n\fR|\fB--lines\fR \fIn\fR\[rB]: Show the log of the service. See \fBase-service-log\fR(1).
-.IP \(bu 4
-\fBstop\fR: Stop the service. See \fBase-service-stop\fR(1).
-.RE 0
-.SH "FILES"
-.RS 0
-.IP \(bu 4
-\fB.ase/service.yaml\fR: The per-project service state (the \fBport\fR of the running service), removed again once the service stopped.
-.IP \(bu 4
-\fB.ase/service.log\fR: The standard output and standard error of the detached service, appended to. As the service inherits the file descriptor for its entire lifetime, the file cannot be rotated while the service runs, and instead is trimmed down to its last 2000 lines whenever a service is started on a file larger than 1 MB.
-.sp
-Routine MCP traffic (session handshakes, notifications, and stream opens) is logged at level \fBdebug\fR only, and the arguments of the logged MCP tool calls are cut at 200 characters.
-.IP \(bu 4
-\fB.ase/.gitignore\fR: The self-ignoring Git ignore file covering the machine-local runtime files, created on the first start if missing.
-.RE 0
-.SH "EXIT STATUS"
-.P
-\fB0\fR on success, \fB1\fR on any error (including a missing \fIcommand\fR). See the individual commands for details.
-.SH "EXAMPLES"
-.P
-.RS 2
-.nf
-# start the service with the full MCP traffic logged
-$ ase --log-level debug service start
-
-# check the service and follow its log
-$ ase service status
-$ ase service log -f
-.fi
-.RE
-.SH "SEE ALSO"
-.P
-\fBase\fR(1), \fBase-service-start\fR(1), \fBase-service-status\fR(1), \fBase-service-send\fR(1), \fBase-service-log\fR(1), \fBase-service-stop\fR(1), \fBase-mcp\fR(1).
-.SH "AUTHOR"
-.P
-Dr. Ralf S. Engelschall \fI\(larse@engelschall.com\(ra\fR

package/dst/man/ase-setup-disable.1

@@ -1,44 +0,0 @@
-.TH "ASE-SETUP-DISABLE" "1" "October 2026" "2.0.3" "Agentic Software Engineering (ASE)"
-.SH "NAME"
-\fBase-setup-disable\fR - Disable the ASE Plugin in an Agent Tool
-.SH "SYNOPSIS"
-.P
-\fBase setup disable\fR \[lB]\fB-h\fR|\fB--help\fR\[rB] \[lB]\fB-t\fR|\fB--tool\fR \fItool\fR\[rB] \[lB]\fB-s\fR|\fB--scope\fR \fIscope\fR\[rB]
-.SH "DESCRIPTION"
-.P
-\fBase setup disable\fR disables the installed \fIASE\fR plugin in the agent tool selected by \fB--tool\fR without uninstalling it, so it can be enabled again via \fBase setup enable\fR. It requires the CLI of the agent tool to be found in \fB$PATH\fR.
-.P
-For \fIAnthropic Claude Code CLI\fR, the plugin is disabled via \fBclaude
-plugin disable ase@ase\fR (with \fB--scope\fR \fIscope\fR for a non-\fBuser\fR scope), which keeps its registration under \fBenabledPlugins\fR (with the value \fBfalse\fR). As \fIGitHub Copilot CLI\fR and \fIOpenAI Codex CLI\fR have no plugin disable command, the plugin is uninstalled there instead (\fBcopilot plugin uninstall ase@ase\fR, resp. \fBcodex plugin remove
-ase@ase\fR, retried up to three times), while its plugin marketplace stays registered.
-.SH "OPTIONS"
-.RS 0
-.IP \(bu 4
-\[lB]\fB-h\fR|\fB--help\fR\[rB]: Show usage information and exit.
-.IP \(bu 4
-\[lB]\fB-t\fR|\fB--tool\fR \fItool\fR\[rB]: Select the target agent tool: \fBclaude\fR, \fBcopilot\fR, or \fBcodex\fR (default: \fB$ASE_TOOL\fR, else \fBclaude\fR).
-.IP \(bu 4
-\[lB]\fB-s\fR|\fB--scope\fR \fIscope\fR\[rB]: Select the plugin installation scope: \fBuser\fR, \fBproject\fR, or \fBlocal\fR. The default is auto-detected from the existing installation: the scopes \fBlocal\fR, \fBproject\fR, and \fBuser\fR are probed in this order, and the first one whose settings file registers the plugin \fBase@ase\fR under \fBenabledPlugins\fR is taken, falling back to \fBuser\fR. Only supported for \fB--tool claude\fR; a non-\fBuser\fR scope for \fBcopilot\fR or \fBcodex\fR fails with an error.
-.RE 0
-.SH "ENVIRONMENT"
-.RS 0
-.IP \(bu 4
-\fBASE_TOOL\fR: The default of \fB--tool\fR.
-.RE 0
-.SH "EXIT STATUS"
-.P
-\fB0\fR on success, \fB1\fR on any error.
-.SH "EXAMPLES"
-.P
-.RS 2
-.nf
-# temporarily disable the ASE plugin in Anthropic Claude Code CLI
-$ ase setup disable
-.fi
-.RE
-.SH "SEE ALSO"
-.P
-\fBase\fR(1), \fBase-setup\fR(1), \fBase-setup-enable\fR(1), \fBase-setup-uninstall\fR(1), \fBase-setup-status\fR(1).
-.SH "AUTHOR"
-.P
-Dr. Ralf S. Engelschall \fI\(larse@engelschall.com\(ra\fR

package/dst/man/ase-setup-enable.1

@@ -1,45 +0,0 @@
-.TH "ASE-SETUP-ENABLE" "1" "October 2026" "2.0.3" "Agentic Software Engineering (ASE)"
-.SH "NAME"
-\fBase-setup-enable\fR - Enable the ASE Plugin in an Agent Tool
-.SH "SYNOPSIS"
-.P
-\fBase setup enable\fR \[lB]\fB-h\fR|\fB--help\fR\[rB] \[lB]\fB-t\fR|\fB--tool\fR \fItool\fR\[rB] \[lB]\fB-s\fR|\fB--scope\fR \fIscope\fR\[rB]
-.SH "DESCRIPTION"
-.P
-\fBase setup enable\fR enables the already installed \fIASE\fR plugin in the agent tool selected by \fB--tool\fR, e.g., after it was disabled via \fBase
-setup disable\fR. It requires the CLI of the agent tool to be found in \fB$PATH\fR.
-.P
-For \fIAnthropic Claude Code CLI\fR, the plugin is enabled via \fBclaude
-plugin enable ase@ase\fR (with \fB--scope\fR \fIscope\fR for a non-\fBuser\fR scope). As \fIGitHub Copilot CLI\fR and \fIOpenAI Codex CLI\fR have no plugin enable command, the plugin is (re-)installed there instead (\fBcopilot
-plugin install ase@ase\fR, resp. \fBcodex plugin add ase@ase\fR, retried up to three times), which requires the \fIASE\fR plugin marketplace to be still registered (see \fBase-setup-install\fR(1)).
-.SH "OPTIONS"
-.RS 0
-.IP \(bu 4
-\[lB]\fB-h\fR|\fB--help\fR\[rB]: Show usage information and exit.
-.IP \(bu 4
-\[lB]\fB-t\fR|\fB--tool\fR \fItool\fR\[rB]: Select the target agent tool: \fBclaude\fR, \fBcopilot\fR, or \fBcodex\fR (default: \fB$ASE_TOOL\fR, else \fBclaude\fR).
-.IP \(bu 4
-\[lB]\fB-s\fR|\fB--scope\fR \fIscope\fR\[rB]: Select the plugin installation scope: \fBuser\fR, \fBproject\fR, or \fBlocal\fR. The default is auto-detected from the existing installation: the scopes \fBlocal\fR, \fBproject\fR, and \fBuser\fR are probed in this order, and the first one whose settings file registers the plugin \fBase@ase\fR under \fBenabledPlugins\fR (enabled or disabled) is taken, falling back to \fBuser\fR. Only supported for \fB--tool claude\fR; a non-\fBuser\fR scope for \fBcopilot\fR or \fBcodex\fR fails with an error.
-.RE 0
-.SH "ENVIRONMENT"
-.RS 0
-.IP \(bu 4
-\fBASE_TOOL\fR: The default of \fB--tool\fR.
-.RE 0
-.SH "EXIT STATUS"
-.P
-\fB0\fR on success, \fB1\fR on any error.
-.SH "EXAMPLES"
-.P
-.RS 2
-.nf
-# re-enable the ASE plugin in Anthropic Claude Code CLI
-$ ase setup enable
-.fi
-.RE
-.SH "SEE ALSO"
-.P
-\fBase\fR(1), \fBase-setup\fR(1), \fBase-setup-disable\fR(1), \fBase-setup-status\fR(1).
-.SH "AUTHOR"
-.P
-Dr. Ralf S. Engelschall \fI\(larse@engelschall.com\(ra\fR

package/dst/man/ase-setup-install.1

@@ -1,73 +0,0 @@
-.TH "ASE-SETUP-INSTALL" "1" "October 2026" "2.0.3" "Agentic Software Engineering (ASE)"
-.SH "NAME"
-\fBase-setup-install\fR - Install the ASE Plugin into an Agent Tool
-.SH "SYNOPSIS"
-.P
-\fBase setup install\fR \[lB]\fB-h\fR|\fB--help\fR\[rB] \[lB]\fB-t\fR|\fB--tool\fR \fItool\fR\[rB] \[lB]\fB-s\fR|\fB--scope\fR \fIscope\fR\[rB] \[lB]\fB-d\fR|\fB--dev\fR\[rB]
-.SH "DESCRIPTION"
-.P
-\fBase setup install\fR installs the \fIASE\fR plugin into the agent tool selected by \fB--tool\fR. It requires \fBnpm\fR(1) and the CLI of the agent tool (\fBclaude\fR, \fBcopilot\fR, or \fBcodex\fR) to be found in \fB$PATH\fR.
-.P
-The installation is performed in two steps through the plugin commands of the agent tool CLI: first, the \fIASE\fR plugin marketplace is registered from a local directory (\fB<cli> plugin marketplace add\fR \fIdir\fR), and then the plugin \fBase@ase\fR is installed from it (\fB<cli>
-plugin install ase@ase\fR, resp. \fBcodex plugin add ase@ase\fR for \fIOpenAI Codex CLI\fR), retried up to three times with a delay of one second.
-.P
-The marketplace directory is the installed \fB@rse/ase\fR package itself, which bundles the plugin, or, with \fB--dev\fR, the local \fIASE\fR working copy.
-.P
-For \fB--tool claude\fR, the plugin-shipped output style \fBase:ase-terse\fR is additionally selected by writing \fB"outputStyle": "ase:ase-terse"\fR into the \fBsettings.json\fR of the installation scope, unless an \fBoutputStyle\fR is already selected there: an \fIASE\fR one is left as is, and a foreign one is preserved with a warning. For \fB--tool copilot\fR and \fB--tool codex\fR, which have no output style concept, the \fBase hook
-session-start\fR handler injects the identical style instructions into the session context instead (see \fBase-hook\fR(1)).
-.P
-The \fIASE\fR tool itself is not installed by this command, as it is already installed when running it (e.g., via \fBnpm install -g
-@rse/ase\fR).
-.SH "OPTIONS"
-.RS 0
-.IP \(bu 4
-\[lB]\fB-h\fR|\fB--help\fR\[rB]: Show usage information and exit.
-.IP \(bu 4
-\[lB]\fB-t\fR|\fB--tool\fR \fItool\fR\[rB]: Select the target agent tool: \fBclaude\fR, \fBcopilot\fR, or \fBcodex\fR (default: \fB$ASE_TOOL\fR, else \fBclaude\fR).
-.IP \(bu 4
-\[lB]\fB-s\fR|\fB--scope\fR \fIscope\fR\[rB]: Select the plugin installation scope: \fBuser\fR (default; registered globally for the current user in \fB~/.claude/settings.json\fR), \fBproject\fR (registered in \fB.claude/settings.json\fR of the current project, meant to be shared via version control), or \fBlocal\fR (registered in \fB.claude/settings.local.json\fR of the current project, kept out of version control).
-.sp
-A non-\fBuser\fR scope is passed as \fB--scope\fR \fIscope\fR to the agent tool CLI. Only supported for \fB--tool claude\fR; a non-\fBuser\fR scope for \fBcopilot\fR or \fBcodex\fR fails with an error.
-.IP \(bu 4
-\[lB]\fB-d\fR|\fB--dev\fR\[rB]: Development mode: register the plugin marketplace from the local \fIASE\fR working copy (\fB$ASE_SETUP_DEV_BASEDIR\fR, else the parent directory of the \fB@rse/ase\fR package directory) instead of the bundled plugin of the installed package (default: \fB$ASE_SETUP_DEV\fR).
-.RE 0
-.SH "ENVIRONMENT"
-.RS 0
-.IP \(bu 4
-\fBASE_TOOL\fR: The default of \fB--tool\fR.
-.IP \(bu 4
-\fBASE_SETUP_DEV\fR: The default of \fB--dev\fR: any non-empty value other than \fB0\fR and \fBfalse\fR (case-insensitive) enables it.
-.IP \(bu 4
-\fBASE_SETUP_DEV_BASEDIR\fR: The local \fIASE\fR working copy used with \fB--dev\fR.
-.RE 0
-.SH "FILES"
-.RS 0
-.IP \(bu 4
-\fB~/.claude/settings.json\fR, \fB.claude/settings.json\fR, \fB.claude/settings.local.json\fR: The settings file of the \fBuser\fR, \fBproject\fR, resp. \fBlocal\fR scope, receiving the \fBoutputStyle\fR selection for \fB--tool claude\fR.
-.RE 0
-.SH "EXIT STATUS"
-.P
-\fB0\fR on success, \fB1\fR on any error (e.g., a missing \fBnpm\fR or agent tool CLI, an invalid option value, or a failing agent tool command, whose output is then shown).
-.SH "EXAMPLES"
-.P
-.RS 2
-.nf
-# install for Anthropic Claude Code CLI, globally for the current user
-$ ase setup install
-
-# install for Anthropic Claude Code CLI, for the current project only
-$ ase setup install --scope project
-
-# install for GitHub Copilot CLI
-$ ase setup install --tool copilot
-
-# install from the local working copy
-$ ase setup install --dev
-.fi
-.RE
-.SH "SEE ALSO"
-.P
-\fBase\fR(1), \fBase-setup\fR(1), \fBase-setup-update\fR(1), \fBase-setup-uninstall\fR(1), \fBase-setup-status\fR(1), \fBase-hook\fR(1).
-.SH "AUTHOR"
-.P
-Dr. Ralf S. Engelschall \fI\(larse@engelschall.com\(ra\fR

package/dst/man/ase-setup-mcp.1

@@ -1,124 +0,0 @@
-.TH "ASE-SETUP-MCP" "1" "October 2026" "2.0.3" "Agentic Software Engineering (ASE)"
-.SH "NAME"
-\fBase-setup-mcp\fR - Manage the Pre-Defined Foreign MCP Servers
-.SH "SYNOPSIS"
-.P
-\fBase setup mcp\fR \[lB]\fB-h\fR|\fB--help\fR\[rB]
-.P
-\fBase setup mcp list\fR \[lB]\fB-h\fR|\fB--help\fR\[rB]
-.P
-\fBase setup mcp activate\fR \[lB]\fB-h\fR|\fB--help\fR\[rB] \[lB]\fB-t\fR|\fB--tool\fR \fItool\fR\[rB] \[lB]\fB-s\fR|\fB--scope\fR \fIscope\fR\[rB] \[lB]\fIservers\fR\[rB]
-.P
-\fBase setup mcp deactivate\fR \[lB]\fB-h\fR|\fB--help\fR\[rB] \[lB]\fB-t\fR|\fB--tool\fR \fItool\fR\[rB] \[lB]\fB-s\fR|\fB--scope\fR \fIscope\fR\[rB] \[lB]\fIservers\fR\[rB]
-.SH "DESCRIPTION"
-.P
-\fBase setup mcp\fR manages the pre-defined \fIforeign MCP servers\fR which \fIASE\fR skills can \fIoptionally\fR leverage for improved quality: the \fIchat\fR servers (leveraged by the skills \fBase-meta-chat\fR and \fBase-meta-quorum\fR) and the \fIsearch\fR servers (leveraged by the skills \fBase-meta-search\fR, \fBase-meta-evaluate\fR, and \fBase-arch-discover\fR). Without a sub-command, the usage information is shown and the command exits with status \fB1\fR.
-.P
-The currently pre-defined servers are (by their \fIid\fR, followed by the registered MCP server name):
-.RS 0
-.IP \(bu 4
-\fBopenai-chatgpt\fR (\fBchat-openai-chatgpt\fR): \fIOpenAI ChatGPT\fR, key \fBASE_MCP_KEY_OPENAI_CHATGPT\fR or \fBASE_MCP_KEY_OPENROUTER\fR.
-.IP \(bu 4
-\fBgoogle-gemini\fR (\fBchat-google-gemini\fR): \fIGoogle Gemini\fR, key \fBASE_MCP_KEY_GOOGLE_GEMINI\fR or \fBASE_MCP_KEY_OPENROUTER\fR.
-.IP \(bu 4
-\fBdeepseek\fR (\fBchat-deepseek\fR): \fIDeepSeek\fR, key \fBASE_MCP_KEY_DEEPSEEK\fR or \fBASE_MCP_KEY_OPENROUTER\fR.
-.IP \(bu 4
-\fBxai-grok\fR (\fBchat-xai-grok\fR): \fIxAI Grok\fR, key \fBASE_MCP_KEY_XAI_GROK\fR or \fBASE_MCP_KEY_OPENROUTER\fR.
-.IP \(bu 4
-\fBalibaba-qwen\fR (\fBchat-alibaba-qwen\fR): \fIAlibaba Qwen\fR, key \fBASE_MCP_KEY_ALIBABA_QWEN\fR or \fBASE_MCP_KEY_OPENROUTER\fR.
-.IP \(bu 4
-\fBzai-glm\fR (\fBchat-zai-glm\fR): \fIZ.AI GLM\fR, key \fBASE_MCP_KEY_ZAI_GLM\fR or \fBASE_MCP_KEY_OPENROUTER\fR.
-.IP \(bu 4
-\fBanthropic-claude\fR (\fBchat-anthropic-claude\fR): \fIAnthropic Claude\fR via the locally installed \fIAnthropic Claude Code CLI\fR, variable \fBASE_MCP_KEY_ANTHROPIC_CLAUDE\fR.
-.IP \(bu 4
-\fBopenai-codex\fR (\fBchat-openai-codex\fR): \fIOpenAI Codex\fR via the locally installed \fIOpenAI Codex CLI\fR, variable \fBASE_MCP_KEY_OPENAI_CODEX\fR.
-.IP \(bu 4
-\fBgithub-copilot\fR (\fBchat-github-copilot\fR): \fIGitHub Copilot\fR via the locally installed \fIGitHub Copilot CLI\fR, variable \fBASE_MCP_KEY_GITHUB_COPILOT\fR.
-.IP \(bu 4
-\fBbrave\fR (\fBsearch-brave\fR): \fIBrave\fR search, key \fBASE_MCP_KEY_BRAVE\fR.
-.IP \(bu 4
-\fBperplexity\fR (\fBsearch-perplexity\fR): \fIPerplexity\fR search, key \fBASE_MCP_KEY_PERPLEXITY\fR.
-.IP \(bu 4
-\fBexa\fR (\fBsearch-exa\fR): \fIExa\fR search, key \fBASE_MCP_KEY_EXA\fR.
-.RE 0
-.P
-The API-based \fIchat\fR servers are registered as stdio servers running \fBnpx -y mcp-to-openai\fR, which bridges to the OpenAI-compatible API of the LLM vendor, or, with the key \fBASE_MCP_KEY_OPENROUTER\fR of an \fIOpenRouter\fR account as a common alternative, to the \fIOpenRouter\fR proxy API.
-.P
-The harness-based \fIchat\fR servers (\fBanthropic-claude\fR, \fBopenai-codex\fR, and \fBgithub-copilot\fR) are registered as stdio servers running \fBnpx -y mcp-to-harness\fR, which bridges to the locally installed agent tool CLI, authenticating via its own configured credentials: their variable carries no API key at all, but the model identifier of the harness, with the special value \fBdefault\fR selecting the default model of the harness.
-.P
-The \fIsearch\fR servers are registered as stdio servers running \fBnpx -y @brave/brave-search-mcp-server\fR resp. \fBnpx -y @perplexity-ai/mcp-server\fR, resp. as an HTTP server on \fBhttps://mcp.exa.ai/mcp\fR for \fBexa\fR.
-.SH "COMMANDS"
-.RS 0
-.IP \(bu 4
-\fBase setup mcp list\fR: List all pre-defined MCP servers known to \fIASE\fR, rendered as a table with the columns \fBID\fR (the server id), \fBNAME\fR (the service name), \fBVERS\fR (the pinned model version, or \fBlatest\fR), \fBMCP\fR (the registered MCP server name), \fBKEY\fR (the accepted suffixes \fIKEY\fR of the environment variables \fBASE_MCP_KEY_\fR\fIKEY\fR, in order of preference), and \fBSKILLS\fR (the \fIASE\fR skills leveraging the server).
-.sp
-It accepts no options besides \fB-h\fR|\fB--help\fR and does not require any agent tool.
-.IP \(bu 4
-\fBase setup mcp activate\fR \[lB]\fB-t\fR|\fB--tool\fR \fItool\fR\[rB] \[lB]\fB-s\fR|\fB--scope\fR \fIscope\fR\[rB] \[lB]\fIservers\fR\[rB]: Register one or more pre-defined MCP servers with the agent tool (via \fB<cli> mcp add\fR). The environment variables \fBASE_MCP_KEY_\fR\fIKEY\fR are first additionally sourced from a \fB.env\fR file in the current directory (if existing). Each selected server takes its key from the first of its variables (see \fBKEY\fR of \fBase setup mcp list\fR) which is set and non-empty.
-.sp
-A server none of whose variables is set is silently skipped when it was selected implicitly (via an empty \fIservers\fR or \fBall\fR), but causes a hard error when it was given explicitly. A prior registration of the same server is removed first, so it is re-created cleanly.
-.IP \(bu 4
-\fBase setup mcp deactivate\fR \[lB]\fB-t\fR|\fB--tool\fR \fItool\fR\[rB] \[lB]\fB-s\fR|\fB--scope\fR \fIscope\fR\[rB] \[lB]\fIservers\fR\[rB]: Unregister one or more pre-defined MCP servers from the agent tool (via \fB<cli> mcp remove\fR). A server which is not currently registered is skipped. No API keys are required.
-.RE 0
-.SH "OPTIONS"
-.RS 0
-.IP \(bu 4
-\[lB]\fB-h\fR|\fB--help\fR\[rB]: Show usage information and exit.
-.IP \(bu 4
-\[lB]\fB-t\fR|\fB--tool\fR \fItool\fR\[rB] (\fBactivate\fR and \fBdeactivate\fR only): Select the target agent tool: \fBclaude\fR, \fBcopilot\fR, or \fBcodex\fR (default: \fB$ASE_TOOL\fR, else \fBclaude\fR). Its CLI has to be found in \fB$PATH\fR.
-.IP \(bu 4
-\[lB]\fB-s\fR|\fB--scope\fR \fIscope\fR\[rB] (\fBactivate\fR and \fBdeactivate\fR only): Select the MCP server registration scope: \fBuser\fR (default; registered globally for the current user), \fBproject\fR (registered in the project and meant to be shared via version control), or \fBlocal\fR (registered in the project, but kept out of version control).
-.sp
-The scope is always passed explicitly to \fIAnthropic Claude Code CLI\fR, as it would otherwise default to \fBlocal\fR. Only supported for \fB--tool claude\fR; a non-\fBuser\fR scope for \fBcopilot\fR or \fBcodex\fR fails with an error.
-.RE 0
-.SH "ARGUMENTS"
-.RS 0
-.IP \(bu 4
-\[lB]\fIservers\fR\[rB] (\fBactivate\fR and \fBdeactivate\fR only): A comma-separated list of server ids (see above). When omitted, empty, or given as the literal \fBall\fR, every pre-defined server is selected. An unknown server id fails with an error listing all known ids.
-.RE 0
-.SH "ENVIRONMENT"
-.RS 0
-.IP \(bu 4
-\fBASE_MCP_KEY_\fR\fIKEY\fR: The API key (resp., for the harness-based servers, the harness model identifier or \fBdefault\fR) of the pre-defined MCP servers, where \fIKEY\fR is one of the suffixes shown in the \fBKEY\fR column of \fBase setup mcp
-list\fR, e.g., \fBASE_MCP_KEY_OPENAI_CHATGPT\fR for \fBopenai-chatgpt\fR. The key is passed to the registered server (e.g., as its environment variable \fBOPENAI_KEY\fR, \fBBRAVE_API_KEY\fR, or \fBPERPLEXITY_API_KEY\fR) and masked in the logged commands.
-.IP \(bu 4
-\fBASE_MCP_KEY_OPENROUTER\fR: The \fIOpenRouter\fR API key, accepted by all API-based \fIchat\fR servers as an alternative to the native API key of the LLM vendor.
-.IP \(bu 4
-\fBASE_TOOL\fR: The default of \fB--tool\fR.
-.RE 0
-.SH "FILES"
-.RS 0
-.IP \(bu 4
-\fB.env\fR: An optional file in the current directory, from which the \fBASE_MCP_KEY_\fR\fIKEY\fR variables are additionally sourced on \fBase setup
-mcp activate\fR.
-.RE 0
-.SH "EXIT STATUS"
-.P
-\fB0\fR on success, \fB1\fR on any error (and when invoked without a sub-command).
-.SH "EXAMPLES"
-.P
-.RS 2
-.nf
-# list all pre-defined MCP servers
-$ ase setup mcp list
-
-# activate all servers whose keys are available
-$ ase setup mcp activate
-
-# activate two search servers for the current project only
-$ ASE_MCP_KEY_BRAVE=... ASE_MCP_KEY_EXA=... \[rs]
-  ase setup mcp activate --scope project brave,exa
-
-# activate the harness-based Anthropic Claude server with its default model
-$ ASE_MCP_KEY_ANTHROPIC_CLAUDE=default ase setup mcp activate anthropic-claude
-
-# deactivate all servers in GitHub Copilot CLI
-$ ase setup mcp deactivate --tool copilot all
-.fi
-.RE
-.SH "SEE ALSO"
-.P
-\fBase\fR(1), \fBase-setup\fR(1), \fBase-setup-status\fR(1), \fBnpx\fR(1).
-.SH "AUTHOR"
-.P
-Dr. Ralf S. Engelschall \fI\(larse@engelschall.com\(ra\fR

package/dst/man/ase-setup-status.1

@@ -1,60 +0,0 @@
-.TH "ASE-SETUP-STATUS" "1" "October 2026" "2.0.3" "Agentic Software Engineering (ASE)"
-.SH "NAME"
-\fBase-setup-status\fR - Report the ASE Registrations of an Agent Tool
-.SH "SYNOPSIS"
-.P
-\fBase setup status\fR \[lB]\fB-h\fR|\fB--help\fR\[rB] \[lB]\fB-t\fR|\fB--tool\fR \fItool\fR\[rB]
-.SH "DESCRIPTION"
-.P
-\fBase setup status\fR reports where \fIASE\fR is currently registered with the agent tool selected by \fB--tool\fR, rendered as a table with the columns \fBKIND\fR, \fBID\fR, \fBSCOPE\fR, and \fBSTATUS\fR. It requires the CLI of the agent tool to be found in \fB$PATH\fR. The rows are:
-.RS 0
-.IP \(bu 4
-\fBPLUGIN\fR: One row per registration of the plugin \fBase@ase\fR (as scraped from the output of \fB<cli> plugin list\fR), with its registration scope and its state (e.g., \fBenabled\fR or \fBdisabled\fR for \fIAnthropic Claude Code CLI\fR, \fBinstalled\fR for \fIGitHub Copilot CLI\fR, and the installation status of \fIOpenAI Codex CLI\fR), or a single row with the status \fBnot
-installed\fR.
-.IP \(bu 4
-\fBMCP\fR: One row per \fIcurrently registered\fR server of the pre-defined MCP servers (see \fBase-setup-mcp\fR(1)), with its MCP server name and its registration scope (as reported by \fB<cli> mcp get\fR), and the status \fBregistered\fR. Unregistered servers are omitted entirely.
-.IP \(bu 4
-\fBOUTPUTSTYLE\fR (\fB--tool claude\fR only): One row per settings file (of the scopes \fBuser\fR, \fBproject\fR, and \fBlocal\fR) carrying an \fBoutputStyle\fR entry, with the status \fBselected\fR (the \fIASE\fR output style \fBase:ase-terse\fR) or \fBforeign\fR (hand-selected).
-.IP \(bu 4
-\fBSTATUSLINE\fR (\fB--tool claude\fR and \fB--tool copilot\fR only): One row per settings file carrying a \fBstatusLine\fR entry, with the status \fBactivated\fR (its command starts with \fBase statusline\fR, i.e., it is owned by \fIASE\fR) or \fBforeign\fR (hand-crafted).
-.IP \(bu 4
-\fBTELEMETRY\fR: One row per configuration file carrying a telemetry export, with the status \fBactivated\fR (towards the \fIASE\fR OTLP ingress) or \fBforeign\fR: for \fBclaude\fR, the \fBenv\fR of \fB~/.claude/settings.json\fR; for \fBcodex\fR, \fB$CODEX_HOME/config.toml\fR; for \fBcopilot\fR, the shell profiles \fB~/.zshrc\fR and \fB~/.bashrc\fR (plus the profile of the login shell), and an \fB$OTEL_EXPORTER_OTLP_ENDPOINT\fR of the environment not pointing to the \fIASE\fR ingress.
-.RE 0
-.P
-Files below the home directory are shown abbreviated with \fB~\fR, and an unparsable settings file is silently skipped. The command is purely read-only and always exits with status \fB0\fR, so a missing registration is reported rather than signalled through the exit code.
-.P
-It takes no \fB--scope\fR, since it deliberately reports \fIall\fR scopes at once -- that is exactly what makes an unintentionally leaked registration visible. Scope information is only available for \fB--tool claude\fR (and, for MCP servers, \fB--tool copilot\fR); everywhere else the scope is reported as \fB(n/a)\fR.
-.SH "OPTIONS"
-.RS 0
-.IP \(bu 4
-\[lB]\fB-h\fR|\fB--help\fR\[rB]: Show usage information and exit.
-.IP \(bu 4
-\[lB]\fB-t\fR|\fB--tool\fR \fItool\fR\[rB]: Select the target agent tool: \fBclaude\fR, \fBcopilot\fR, or \fBcodex\fR (default: \fB$ASE_TOOL\fR, else \fBclaude\fR).
-.RE 0
-.SH "ENVIRONMENT"
-.RS 0
-.IP \(bu 4
-\fBASE_TOOL\fR: The default of \fB--tool\fR.
-.IP \(bu 4
-\fBCOPILOT_HOME\fR, \fBCODEX_HOME\fR: The configuration directories of \fIGitHub Copilot CLI\fR (default: \fB~/.copilot\fR) and \fIOpenAI Codex CLI\fR (default: \fB~/.codex\fR).
-.RE 0
-.SH "EXIT STATUS"
-.P
-\fB0\fR in all regular cases, \fB1\fR only on an error like an invalid option value or a missing agent tool CLI.
-.SH "EXAMPLES"
-.P
-.RS 2
-.nf
-# report the ASE registrations for Anthropic Claude Code CLI
-$ ase setup status
-
-# report the ASE registrations for OpenAI Codex CLI
-$ ase setup status --tool codex
-.fi
-.RE
-.SH "SEE ALSO"
-.P
-\fBase\fR(1), \fBase-setup\fR(1), \fBase-setup-install\fR(1), \fBase-setup-mcp\fR(1), \fBase-setup-statusline\fR(1), \fBase-setup-telemetry\fR(1).
-.SH "AUTHOR"
-.P
-Dr. Ralf S. Engelschall \fI\(larse@engelschall.com\(ra\fR

package/dst/man/ase-setup-statusline.1

@@ -1,92 +0,0 @@
-.TH "ASE-SETUP-STATUSLINE" "1" "October 2026" "2.0.3" "Agentic Software Engineering (ASE)"
-.SH "NAME"
-\fBase-setup-statusline\fR - Activate or Deactivate the ASE Statusline
-.SH "SYNOPSIS"
-.P
-\fBase setup statusline\fR \[lB]\fB-h\fR|\fB--help\fR\[rB]
-.P
-\fBase setup statusline activate\fR \[lB]\fB-h\fR|\fB--help\fR\[rB] \[lB]\fB-t\fR|\fB--tool\fR \fItool\fR\[rB] \[lB]\fB-s\fR|\fB--scope\fR \fIscope\fR\[rB] \[lB]\fB-w\fR|\fB--width\fR \fIn\fR\[rB] \[lB]\fB-m\fR|\fB--margin\fR \fIn\fR\[rB] \[lB]\fB-p\fR|\fB--padding\fR \fIn\fR\[rB] \[lB]\fB--no-icons\fR\[rB] \[lB]\fB--no-labels\fR\[rB] \[lB]\fIformat\fR \[lB]...\[rB]\[rB]
-.P
-\fBase setup statusline deactivate\fR \[lB]\fB-h\fR|\fB--help\fR\[rB] \[lB]\fB-t\fR|\fB--tool\fR \fItool\fR\[rB] \[lB]\fB-s\fR|\fB--scope\fR \fIscope\fR\[rB]
-.SH "DESCRIPTION"
-.P
-\fBase setup statusline\fR activates or deactivates the \fIASE\fR statusline, i.e., the \fBase statusline\fR renderer (see \fBase-statusline\fR(1)) configured as the \fBstatusLine\fR command in the settings file of the agent tool. Without a sub-command, the usage information is shown and the command exits with status \fB1\fR.
-.P
-The statusline is supported for \fIAnthropic Claude Code CLI\fR (\fBclaude\fR) and \fIGitHub Copilot CLI\fR (\fBcopilot\fR) only, while \fIOpenAI Codex CLI\fR (\fBcodex\fR) has no scriptable statusline mechanism, so \fB--tool codex\fR fails with an error.
-.P
-The settings file is, for \fBclaude\fR, \fB~/.claude/settings.json\fR (scope \fBuser\fR), \fB.claude/settings.json\fR (scope \fBproject\fR), resp. \fB.claude/settings.local.json\fR (scope \fBlocal\fR) relative to the current working directory, and, for \fBcopilot\fR, the single per-user \fB$COPILOT_HOME/settings.json\fR (default: \fB~/.copilot/settings.json\fR). The settings file is edited in place (preserving its formatting and all other entries) and written atomically, and a missing settings file (and its directory) is created.
-.P
-A \fBstatusLine\fR entry counts as owned by \fIASE\fR if its \fBcommand\fR starts with \fBase statusline\fR. A foreign, hand-crafted \fBstatusLine\fR entry is never touched by either sub-command: it is preserved with a warning, and the command still exits with status \fB0\fR.
-.SH "COMMANDS"
-.RS 0
-.IP \(bu 4
-\fBase setup statusline activate\fR \[lB]\fIoptions\fR\[rB] \[lB]\fIformat\fR \[lB]...\[rB]\[rB]: Add the \fBstatusLine\fR entry of \fIASE\fR to the settings file, or update an existing one of \fIASE\fR in place.
-.sp
-The entry is the object \fB{ "type": "command", "command": "ase statusline ...", "padding": 0 }\fR, whose command is \fBase statusline --tool\fR \fItool\fR \fB-w\fR \fIwidth\fR \fB-m\fR \fImargin\fR \fB-p\fR \fIpadding\fR, followed by \fB--no-icons\fR and \fB--no-labels\fR if given, and the \fIformat\fR lines, each one single-quoted for the shell (resp. double-quoted for \fBcopilot\fR on Windows, which spawns the command via \fBcmd.exe\fR).
-.IP \(bu 4
-\fBase setup statusline deactivate\fR \[lB]\fIoptions\fR\[rB]: Remove the \fBstatusLine\fR entry of \fIASE\fR from the settings file. A missing settings file or a missing \fBstatusLine\fR entry is skipped with an informational message.
-.RE 0
-.SH "OPTIONS"
-.RS 0
-.IP \(bu 4
-\[lB]\fB-h\fR|\fB--help\fR\[rB]: Show usage information and exit.
-.IP \(bu 4
-\[lB]\fB-t\fR|\fB--tool\fR \fItool\fR\[rB]: Select the target agent tool: \fBclaude\fR or \fBcopilot\fR (default: \fB$ASE_TOOL\fR, else \fBclaude\fR). \fBcodex\fR is rejected with an error.
-.IP \(bu 4
-\[lB]\fB-s\fR|\fB--scope\fR \fIscope\fR\[rB]: Select the settings file of the scope \fBuser\fR (default), \fBproject\fR, or \fBlocal\fR (see above). Only supported for \fB--tool claude\fR; a non-\fBuser\fR scope for \fBcopilot\fR, which has a single per-user settings file, fails with an error.
-.IP \(bu 4
-\[lB]\fB-w\fR|\fB--width\fR \fIn\fR\[rB] (\fBactivate\fR only): Force the terminal width of the statusline rendering to \fIn\fR characters, where \fB0\fR (default) auto-detects it via \fB/dev/tty\fR. Has to be a non-negative integer.
-.IP \(bu 4
-\[lB]\fB-m\fR|\fB--margin\fR \fIn\fR\[rB] (\fBactivate\fR only): Reduce the maximum used terminal width by \fIn\fR characters on each side (default: \fB2\fR). Has to be a non-negative integer.
-.IP \(bu 4
-\[lB]\fB-p\fR|\fB--padding\fR \fIn\fR\[rB] (\fBactivate\fR only): Pad each rendered line with \fIn\fR spaces on the left and right side (default: \fB0\fR). Has to be a non-negative integer.
-.IP \(bu 4
-\[lB]\fB--no-icons\fR\[rB] (\fBactivate\fR only): Disable the leading icon glyph in front of each placeholder rendering.
-.IP \(bu 4
-\[lB]\fB--no-labels\fR\[rB] (\fBactivate\fR only): Disable the textual label in front of the bold value of each placeholder rendering.
-.RE 0
-.SH "ARGUMENTS"
-.RS 0
-.IP \(bu 4
-\[lB]\fIformat\fR \[lB]...\[rB]\[rB] (\fBactivate\fR only): One or more statusline template lines of literal text, \fB%\fR-prefixed placeholders, and \fB<\fR\fIcolor\fR\fB>\fR...\fB</\fR\fIcolor\fR\fB>\fR markup (see \fBase-statusline\fR(1) for all placeholders and colors). Without any \fIformat\fR, the following three default lines are used: \fB<blue>%u</blue> <red>%p</red> <black>%T</black> %s\fR (user, project, task, and session), \fB%m %e %t\fR (model, effort, and thinking), and \fB%P %h %B %c\fR (persona, guidance level, boxing, and context usage).
-.RE 0
-.SH "ENVIRONMENT"
-.RS 0
-.IP \(bu 4
-\fBASE_TOOL\fR: The default of \fB--tool\fR.
-.IP \(bu 4
-\fBCOPILOT_HOME\fR: The configuration directory of \fIGitHub Copilot CLI\fR (default: \fB~/.copilot\fR).
-.RE 0
-.SH "FILES"
-.RS 0
-.IP \(bu 4
-\fB~/.claude/settings.json\fR, \fB.claude/settings.json\fR, \fB.claude/settings.local.json\fR: The settings files of \fIAnthropic Claude Code CLI\fR of the scopes \fBuser\fR, \fBproject\fR, and \fBlocal\fR.
-.IP \(bu 4
-\fB$COPILOT_HOME/settings.json\fR (default: \fB~/.copilot/settings.json\fR): The settings file of \fIGitHub Copilot CLI\fR.
-.RE 0
-.SH "EXIT STATUS"
-.P
-\fB0\fR on success (including a preserved foreign \fBstatusLine\fR entry), \fB1\fR on any error (and when invoked without a sub-command).
-.SH "EXAMPLES"
-.P
-.RS 2
-.nf
-# activate the ASE statusline with its default lines
-$ ase setup statusline activate
-
-# activate a single custom line for the current project only
-$ ase setup statusline activate --scope project "%p %T %m %c"
-
-# activate the ASE statusline in GitHub Copilot CLI without icons
-$ ase setup statusline activate --tool copilot --no-icons
-
-# deactivate the ASE statusline again
-$ ase setup statusline deactivate
-.fi
-.RE
-.SH "SEE ALSO"
-.P
-\fBase\fR(1), \fBase-setup\fR(1), \fBase-statusline\fR(1), \fBase-setup-status\fR(1).
-.SH "AUTHOR"
-.P
-Dr. Ralf S. Engelschall \fI\(larse@engelschall.com\(ra\fR