convez.ai
AgenteDevOps & InfraestruturaAvançado
AgentAirlift

Agent Airlift

AgentAirlift/AgentAirlift

Transfira sessões de código entre agentes IA com normalização determinística

Ver no GitHub
InicialPluginScore · de 0 a 100

CLI 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/AgentAirlift

1 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

Estrelas
12
Forks
0
Acompanhando
1
Saúde
37%
Último commit
há 4 meses
Versão
—
Issues abertas
0
Contribuidores
3

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.

FormatShape
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
codexsession_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
Ver o original no GitHub

Bom para

Relacionados