Agent Airlift
AgentAirlift/AgentAirlift
Transfira sessões de código entre agentes IA com normalização determinística
Ver no GitHubCLI local e determinístico em Rust que transfere manualmente sessões de codificação de IA de um agente para outro (ex: Claude Code → Codex/Kiro/OpenCode). Importa a sessão, normaliza para um schema canônico e gera documentação de handoff com exports legíveis. Sem chamadas de API durante a geração — transferências sempre explícitas.
Instalação
npx convez-ai AgentAirlift/AgentAirlift1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Migrar sessões de codificação entre diferentes provedores de IA
- Auditar e normalizar históricos de sessões de código
- Gerar documentação de handoff para continuidade em projetos IA
Veredito

Ferramenta especializada e robusta para times que precisam portabilidade entre agentes de código. Implementação sólida em Rust com garantias de determinismo, mas nicho específico — ideal para orquestração multi-provider de sessões IA.
README
A tradução para o português deste README ainda está na fila.
Agent Airlift
A local, deterministic CLI that performs a manual transfer of an AI coding session from one agent to another (e.g. Claude Code → Codex / Kiro / OpenCode). It imports a session, normalizes it to a canonical schema, and emits handoff docs plus readable, target-shaped exports. Optional direct Marginlab provider-health signal ingestion is supported but never required.
Scope note: The core CLI is deterministic and calls no AI APIs during generation. Transfers are always explicit. Optional Claude Code / Codex plugins (see
plugins/) add on-demand provider-health checks and recommend a transfer when a provider looks degraded — but they only ever invoke the same explicit migration workflow described here.
Quick start
cargo run -- demo \
--session examples/sessions/claude-code-realistic.jsonl \
--project examples/projects/tiny-rust-cli \
--out ./airlift-out \
--source claude-code \
--targets codex,kiro,opencode \
--provider-health none
Output is written under airlift-out/:
raw/ source session copy, repo snapshot, provider-health, marginlab-response
normalized/ canonical-session.json (deterministic schema)
replay/ agent-airlift.session.jsonl
exports/ HANDOFF.md, AGENTS.md, codex/kiro/opencode exports, .kiro specs
audit/ conversion-report.md, warnings.json, dropped-fields.json,
import-diagnostics.json
demo is an alias of migrate (the full pipeline). A lightweight health
subcommand runs only the provider-health step and persists
<out>/provider-health.json — useful for the plugins below:
cargo run -- health --source claude-code \
--provider-health marginlab \
--provider-health-cache-file examples/provider-health/degraded.marginlab.cached.json
# prints the normalized signal + a line:
# AIRLIFT_HEALTH status=degraded provider=claude-code confidence=0.74 source=cached-marginlab
Supported import formats
The importer tolerates JSONL variations and never panics on malformed lines —
bad rows become structured warnings. Detected format and a confidence score are
recorded in audit/import-diagnostics.json.
| Format | Shape |
|---|---|
claude-code | {type, message:{role, content: string | blocks}}; tool_use / tool_result blocks captured; compact continuation summaries are provenance-marked as summary; meta and unknown records are preserved instead of dropped |
codex | session_meta + event_msg (user/agent) + response_item (deduped) |
flat | {id, role, content, timestamp, ...} (unknown fields preserved) |
Realistic example fixtures live in examples/sessions/:
claude-code-realistic.jsonl, codex-realistic.jsonl, edge-cases.jsonl.
Canonical schema
Each canonical turn carries stable id, role, content, timestamp,
source (provenance), content_blocks, tool_calls, tool_results, and
metadata (preserved unknown fields). The schema is deterministic. It captures
only observable conversation data — it does not reconstruct model hidden
state or chain-of-thought.
Resume compatibility
Target exports under exports/ are readable, deterministic representations of
the session, not native session files. Native resume compatibility is not
guaranteed; use the exports plus HANDOFF.md / AGENTS.md to seed a fresh
session in the target tool.
Provider health (optional)
# file mode (no network, no token)
--provider-health file --provider-health-file examples/provider-health/degraded.marginlab.cached.json
# marginlab mode: fetches the live tracker directly; falls back to cache if fetch fails
# "Collecting baseline data" is treated as unknown because degradation detection is paused
--provider-health marginlab \
--provider-health-cache-file examples/provider-health/degraded.marginlab.cached.json
Generated docs distinguish the signal source from the evaluated provider, e.g.
"Provider health signal from cached-marginlab: claude-code is degraded."
Plugins (optional)
On-demand Claude Code and Codex plugins live under plugins/ and add
two slash commands each:
/airlift-check— refresh the provider-health signal; if the active provider looks degraded, recommend airlifting to the other harness./airlift-migrate— run the (unchanged) migration pipeline on the current session and emit a handoff bundle for the other harness.
Pairing is cross-tool: the Claude plugin checks claude-code and airlifts to
codex; the Codex plugin checks codex and airlifts to claude-code. The
plugins are thin front-ends that shell out to agent-airlift health / migrate
— no new conversion logic. See plugins/SPEC.md and each
plugin's README for install and configuration. For local development, refresh
both installed plugins with:
./scripts/agent-airlift install-all
Individual installers are also available: install-codex and install-claude.
Decision records (optional)
For higher-fidelity handoffs, add the paste-ready snippet in
examples/decision-records.md to a project's
CLAUDE.md or AGENTS.md. Agent Airlift extracts DECISION, RATIONALE, and
STATUS records into handoff artifacts without AI summarization.
Tests
cargo test