AgentMove

Moves: a coding agent's session on a laptop (Claude Code, Codex, OpenCode, Hermes or OpenClaw) copies itself onto a NoClick agent and carries on there. The laptop keeps its own session.

Your side makes the move and follows it; the agent in the session does the rest, from the guide its prompt names:

move = noclick.AgentMove.create(name="Docs fixer")
print(move.prompt)        # paste into the session you want moved
...
move.refresh()
print(move.status, move.arrived["files"])   # moving, what it carried so far
print(move.agent_id, move.conversation)     # once done

The agent's side runs with the move's own key, which its code is redeemed for once (AgentMove.redeem): it can reach nothing but the move, and ends with it.

key = noclick.AgentMove.redeem("nc_move_...", host="ana-mbp")
moving = noclick.AgentMove.current(client=noclick.Client(api_key=key))
moving.upload_session(tar_bytes, harness="claude_code", cwd="/Users/ana/code/acme")
moving.finish()

class AgentMove

A move from a laptop: waiting for its code to be redeemed, moving while what the agent carries arrives (arrived), finishing while the agent is made (steps), then done with agent_id and conversation; failed (finish again), canceled or expired.

Like every live object, it also has hydrate(), refresh() and raw.

Attributes

id	str
status	str	One of `waiting`, `moving`, `finishing`, `done`, `failed`, `canceled`, `expired`.
code	str \| None	The one-time code (from `create` only): it works once, for 30 minutes.
prompt	str \| None	What a person pastes into the session to move (from `create` only): the guide and the code.
guide_url	str	The guide the moving agent follows.
workspace_id	str \| None	The space the agent joins.
draft	dict[str, Any]	What the move was made with: `name`, `harness`, `model`, `model_connection`.
source	dict[str, Any] \| None	Where it moves from, as the moving agent says: `harness`, `host`, `cwd`, `cli_version`, `session_id`, `title`.
arrived	dict[str, Any]	What arrived so far: `session`, `repo` or `checkout`, `files`, `consent`, `secrets` (names and where each goes), `setup`, `mcp_servers`, `skills`, `memories`, `note`, `instructions`, `plan`, and once finished `carried`; never a value.
steps	list[dict[str, Any]]	The finish's progress, in order: each `name` (agent, space, files, tools, skills, memories, conversation), `label`, `status` (running, done, failed), `detail` and `error`.
lands_as	dict[str, Any] \| None	Where it lands (on the moving side): the agent's `name` and `harness`, and `cwd`, the working directory its session moves to.
question	str \| None	What a finish asks before it makes anything (a session that carried no MCP server and no skill: does it have none?).
endpoints	list[str] \| None	The move's calls (on the moving side), one line each: method, path and what it does.
agent_id	str \| None	The agent it made, once done.
conversation	str \| None	The agent's conversation holding the moved session.
error	str \| None	Why it failed.
expires_at	Any	When it ends if nobody finishes it.
created_at	Any

createclassmethodasync

noclick.AgentMove.create(
    *, workspace=None, name=None, harness=None, model=None, model_connection=None,
    user=..., client=None
) -> AgentMove

Make a move: a one-time code, good once for 30 minutes, and the prompt a person pastes into the coding-agent session they want moved. The agent there follows the guide the prompt names, carries what its work needs, and finishes the move, which makes the agent.

Args: workspace: The space (a Workspace or its id) the agent joins. name: Its name; omitted, the moving agent's choice, else its folder's. harness: claude_code, codex, opencode, hermes or openclaw; omitted, the session's own. model: Its model in the harness's format; omitted, the session's or the harness's default. model_connection: The connection holding its model's key or plan; omitted, the account's own that runs it.

Parameters

workspaceAnydefault None

namestr | Nonedefault None

harnessstr | Nonedefault None

modelstr | Nonedefault None

model_connectionAnydefault None

userAny

Who the call acts for. Defaults to the user set by noclick.as_user (none: the account itself).

(defaults to the current user)

clientClient | None

The client to send with; defaults to the module client built from NOCLICK_API_KEY.

(default None)

Returns

createclassmethodasync

from_idclassmethod

redeemstatic

currentclassmethodasync