Crate agentport 

Agentport

Install agent skills and plugins without guessing where their files will go.

Agentport is an interactive terminal installer for Codex, Claude Code, and GitHub Copilot. Give it a public GitHub repository, local directory, ZIP file, or tar archive; it discovers the package contents, detects compatible agents, and previews every destination before writing anything.

Why Agentport?

Agent packages use different layouts and every coding agent expects a different destination. Agentport provides one reviewable workflow:

• Discover skills, command-style skills, agent definitions, hooks, and Codex plugins from a package.
• Select individual artifacts instead of installing everything blindly.
• Install globally or into the current project using each agent’s native directory layout.
• Keep Codex plugin bundles intact and install them through the Codex CLI.
• Require explicit approval before installing hooks, scripts, or MCP content.
• Record hashes so uninstall removes unchanged files and preserves local edits.

Install

cargo install agentport

Agentport supports macOS and Linux and requires Rust 1.88 or newer. Native Codex plugin installation also requires a recent codex executable that provides the codex plugin commands.

Quick start

Open the source field in the TUI:

agentport

Or scan a source immediately:

agentport https://github.com/DietrichGebert/ponytail
agentport ./my-skill
agentport ~/Downloads/skills.zip
agentport ~/Downloads/skills.tar.gz

The installer then walks through five reviewable steps:

1. Select discovered artifacts.
2. Choose detected target agents.
3. Choose global or project scope.
4. Approve active content only when you intend to install it.
5. Review exact destinations and install.

Agentport is interactive and requires a TTY. GitHub URLs must point to public repositories; clone private repositories first and install from the local checkout.

What gets installed?

Component	Codex	Claude Code	GitHub Copilot
Skills and command-style skills	Global or project	Global or project	Global or project
Agent definitions	—	Global or project	Global or project
Codex plugins	Native CLI, global	—	—
Standalone hooks	Managed local plugin	Detected, not merged	Compatible schemas
Standalone MCP configuration	Detected, not merged	Detected, not merged	Detected, not merged

Agentport does not merge standalone MCP configuration into existing agent configuration because there is no safe, lossless cross-agent destination. MCP servers bundled in a Codex plugin remain part of that native plugin.

Skill destinations

Agent	Global	Project
Codex	~/.codex/skills	.agents/skills
Claude Code	~/.claude/skills	.claude/skills
GitHub Copilot	~/.copilot/skills	.github/skills

CODEX_HOME, CLAUDE_CONFIG_DIR, and COPILOT_HOME are honored.

Codex plugin behavior

Repository-root Codex marketplaces are registered directly. Local directories, archives, direct plugins, and standalone hooks.json packages are copied into durable Agentport-managed local marketplaces before native installation. Plugins are global-only so their skills, hooks, MCP servers, and assets remain one bundle.

After installing a plugin with hooks, restart Codex or start a new thread, then open /hooks to review and trust the definitions. Agentport never grants hook trust automatically.

Manage installations

Inspect everything Agentport owns:

agentport list

Choose an installation interactively or name one directly:

agentport uninstall
agentport uninstall <installation-id-or-package-name>

Install records normally live in ~/.local/share/agentport. During uninstall, Agentport removes only files whose hashes still match the installed versions. Modified files are reported and preserved.

Safety model

• Existing unmanaged destinations are never overwritten.
• Archive extraction rejects traversal paths, links, unsupported entry types, excessive entry counts, and oversized payloads.
• Executable skill content, hooks, and MCP definitions require explicit approval.
• Conflicting Codex marketplace sources are rejected.
• File writes are staged and renamed into place; failed targets are rolled back.
• Uninstall preserves files changed after installation.

Agentport installs third-party instructions and can install executable content when you approve it. Review the source and final destination preview before continuing. Report vulnerabilities according to the security policy.

Development

cargo fmt --all -- --check
cargo clippy --all-targets --all-features -- -D warnings
cargo test --all-targets --all-features
cargo package --locked

• Contributing guide
• Podman TUI testing
• Release process
• Changelog

License

Agentport is available under the MIT License.

Re-exports

pub use adapters::AgentAdapter;

pub use adapters::detect_agents;

pub use install::CodexCommandRunner;

pub use install::InstallRequest;

pub use install::build_plan;

pub use install::execute_plan;

pub use install::execute_plan_with_runner;

pub use install::uninstall;

pub use install::uninstall_with_runner;

pub use scanner::ArtifactScanner;

pub use scanner::DefaultScanner;

pub use source::DefaultSourceProvider;

pub use source::PreparedSource;

pub use source::SourceProvider;

pub use state::StateStore;

pub use model::*;

Modules

adapters

install

model

scanner

source

state