agterm
v0.34.0Drive agterm, a native macOS terminal, programmatically via its agtermctl CLI and local control socket.
By UmputunLicense: MIT642 GitHub starsUpdated 1 hour ago
Directory evidence
- Runtimes
- Codex and Claude Code
- Parsed components
- 1 skill or MCP entry
- Source updated
- Oct 1, 2026
- Manifest status
- Canonical path parsed
The directory validates manifest shape and source location. It does not execute the plugin or provide a security endorsement. Review the indexing methodology →
Install agterm for Codex and Claude Code
codex plugin marketplace add umputun/agterm
codex plugin marketplace upgrade agterm
codex plugin add agterm@agtermPaste and run these commands in a terminal with Codex. They add and refresh the agterm catalog, then install this plugin.
Compatibility: the page URL and API slug “agterm” remain stable.
- Codex:
agterm@agent-plugin-marketplace→agterm@agterm
The installer fetches third-party code from the source repository shown on this page. This directory validates manifest structure and source location, but does not perform a security audit; review the manifest, components, and source before installing.
Get the source manually
git clone https://github.com/umputun/agtermClone the source repository, then follow its setup instructions to add the plugin to a compatible client. The plugin root is plugins/agterm/.
Plugin files
├── .codex-plugin/plugin.json├── .claude-plugin/plugin.json└── skills/agterm/SKILL.md
Included Skills1
Drive agterm, a native macOS terminal, through its agtermctl CLI. Use when running inside an agterm session and asked to control the terminal: create, rename, close, select or reorder sessions and workspaces; split panes; toggle the scratch terminal; run a program in an overlay and read its exit status; create and show HTML pages, interactive ones too, URLs or dev servers in an overlay; post a HUD or a desktop notification; show a picker or question dialog; display an image inline; type into a session, copy its selection or search its scrollback; manage windows; change font size; set the theme; reload or edit the keymap, event hooks and agterm-scoped ghostty config; subscribe to status, notification, lifecycle, pane-visibility and tree-change events. Covers the window/workspace/session addressing model and the AGTERM_* environment a spawned shell sees, attaching a session running on another Mac, the cookbook recipes, the running version, and diagnosing problems or filing an agterm bug or feature request.
Plugin manifests2
{
"name": "agterm",
"version": "0.34.0",
"description": "Drive agterm, a native macOS terminal, programmatically via its agtermctl CLI and local control socket.",
"author": {
"name": "Umputun"
},
"homepage": "https://agterm.com",
"repository": "https://github.com/umputun/agterm",
"license": "MIT",
"keywords": [
"agterm",
"terminal",
"macos",
"automation",
"control-socket"
],
"skills": "./skills/",
"interface": {
"displayName": "agterm",
"shortDescription": "Drive the agterm macOS terminal from Codex",
"developerName": "Umputun",
"category": "Productivity",
"websiteURL": "https://agterm.com"
}
}{
"name": "agterm",
"version": "0.34.0",
"description": "Drive agterm, a native macOS terminal, programmatically via its agtermctl CLI and local control socket.",
"author": {
"name": "Umputun"
},
"homepage": "https://agterm.com",
"repository": "https://github.com/umputun/agterm",
"license": "MIT",
"keywords": [
"agterm",
"terminal",
"macos",
"automation",
"control-socket"
],
"skills": [
"./skills/agterm"
]
}For maintainers
If you maintain this plugin, link to this source-backed listing from your README so users can review its manifest and indexed components.
[agterm on Agent Plugins Marketplace](https://pluginsmp.com/plugins/agterm)