Skip to main content

​
Bring an existing agent into Harnest

Choose the mode that preserves the agent’s current behavior:
1

Create a Harnest project beside the existing agent

Use --framework langgraph for an existing LangGraph agent.
2

Move the agent and its dependencies

Export a managed Agent or Graph, or wrap the existing native target with Agent.advanced(...). Add only agent-owned packages to pyproject.toml.
3

Test through the harness

Advanced mode is not a dead end. Move tools, skills, MCP connections, lifecycle hooks, and other compatible pieces into managed folders when useful.

​
Upgrade an older Harnest project

1

Preview the migration

This command is read-only. Review its plan before continuing.
2

Apply the reviewed migration

3

Test the upgraded project

Harnest checks that reviewed files have not changed and creates backups under .harnest/upgrade-backups/. It stops when a change needs your judgment.

​
Switch between ADK and LangGraph

For a managed agent, change spec.framework.name in config.yaml:
Then validate the target framework:
Review native extensions, evals, sandboxes, custom nodes, and active checkpoints first. Advanced projects need a manual migration.
Follow the framework migration checklist.