@heshamfsalama/agentport
v0.1.0
Published
AgentPort CLI: a safe migration planner and AgentPack compiler for AI coding-agent environments.
Maintainers
Readme
AgentPort
AgentPort is a safe migration planner and compiler for AI coding-agent environments.
It scans tools like Claude Code, Codex, and Gemini CLI, normalizes their configuration into an AgentPack, produces a reviewed migration plan, and applies that plan only after explicit approval.
The goal is not to copy random folders. The goal is a standard, inspectable way to move agent instructions, MCP servers, skills, commands, permissions, and automation between coding agents without silently leaking secrets or changing behavior.
Product Model
- AgentPort: the CLI and migration engine.
- AgentPack: the portable JSON artifact and schema.
- Adapter: a scanner/emitter for a specific tool.
- Migration plan: a reviewed list of writes, manual actions, skipped items, and portability labels.
Recommended First Run
Without installing:
npx @heshamfsalama/agentport doctor --project .Or install globally:
npm install -g @heshamfsalama/agentportagentport doctor --project .
agentport scan --from auto --scope all --project . --cwd . --out agentpack.json
agentport plan --pack agentpack.json --to codex --target-scope same --out migration.plan.json
agentport apply --plan migration.plan.json --dry-runOnly apply after reviewing migration.plan.json:
agentport apply --plan migration.plan.json --yesagentmigrate remains as a backward-compatible alias while the project transitions to AgentPort.
Safety Defaults
scanandplando not write target files.- Secrets are redacted into environment variable references.
- Raw conversations are not imported.
- Hooks and permissions that do not map exactly are flagged for manual review.
- Marketplace plugins are cataloged but not installed.
- Managed organization policy is never auto-written.
- Local/private project scope stays private unless explicitly promoted.
Supported V1 Adapters
- Claude Code
- Codex
- Gemini CLI
The compatibility catalog also tracks research-only entries for Cursor, Windsurf, Antigravity, Kiro, Amp, Aider, OpenCode, Goose, Zed, JetBrains Junie, GitHub Copilot CLI, Amazon Q Developer, Continue, Cline, Roo Code, Trae, Augment, Replit Agent, and Devin.
Who Should Look At This
AgentPort is meant for users and maintainers of AI coding-agent tools who care about portable, reviewable configuration. Relevant ecosystems include OpenAI Codex, Anthropic Claude Code, Google Gemini CLI and Antigravity, Cursor, Windsurf, Kiro, Amazon Q Developer, Sourcegraph Amp, Aider, OpenCode, Goose, Cline, Roo Code, Continue, Zed, JetBrains Junie, and GitHub Copilot.
This list is not an endorsement claim. It is a map of tools whose users may benefit from a shared migration format.
Documentation
- Quickstart
- AgentPack Standard
- Scope Model
- Platform Paths
- Migration UX
- Safety Model
- Adapter Authoring
- Compatibility Catalog
- Standardization Strategy
- GitHub Publish Notes
Contributing
Contributions are welcome. The most useful early contributions are sanitized fixtures, adapter research facts, and tests for new tool paths.
Read CONTRIBUTING.md before opening a PR.
Security
Please do not paste private configs, credentials, or raw conversations into public issues. See SECURITY.md.
Current Status
This is V1. It is useful today for local migration planning between Claude Code, Codex, and Gemini CLI, and it is structured so the community can add adapters without changing the core standard.
