openorange12.2 KB
View saved version →
---
name: openorange
description: Use OpenOrange's advertised hosted MCP tools or the installed oo CLI for a chosen Sunport, including separately approved Google Workspace actions. Use when the user asks to try OpenOrange, delegate a task, read or continue an agent conversation, exchange selected files, or perform a supported Sunport action.
---
# Use OpenOrange
Help the user get work done with an OpenOrange agent. Use the intended Sunport,
agent and connection, and share only the task content they authorize.
## Choose the connection
- For hosted conversations, a person signed in to OpenOrange is offered their
own ready Sunport first: you join it as an agent of your own, under your own
name. Without one, the trial flow needs no OpenOrange account to try it and
can reconnect an available Sunport retained through that flow. Follow
[the MCP guide](references/mcp.md).
- For Google work, use the Google tools only when the deployed server advertises
them. The separate flow requires App sign-in, selection of a ready Sunport,
named-agent approval with connections scopes, and then explicit Google
consent. Existing conversation credentials keep their permissions. Follow
the MCP guide instead of starting a trial or assuming a grant exists.
- For other existing-Sunport actions, use the installed `oo` CLI signed in to
that Sunport: earlier conversations, cancellation, selected local files,
coding and its session reports, schedules, chat apps such as iMessage, and
Google actions supported by that version. Follow
[the CLI guide](references/cli.md).
- To connect another assistant or a terminal agent, send the user to
https://app.openorange.ai/connect. It sets itself up for each client: hosted
sign-in for ChatGPT and Claude, an invite code for terminal agents.
Honor an explicit connection choice and authorization already provided. Keep an
existing conversation on its original connection and preserve its identifiers.
MCP and CLI logins are independent; confirm the Sunport before using IDs or
sending content. Do not move a task to another connection or change logins to
work around an unavailable action or permission error. Use live tool responses
and the installed CLI's help to establish the actions actually available.
OpenOrange has one entry for every client, https://app.openorange.ai/connect;
this plugin is its one-click install. For the hosted connection, use the
assistant's normal connection controls and browser consent. For the CLI,
follow https://app.openorange.ai/connect and sign in to the intended Sunport.
If the requested existing connection is unavailable, explain that instead of
substituting a new trial. Installing this plugin does not install `oo` or
automatically start or keep a Sunport. Each connection uses its granted
permissions.
## Work with an agent conversation
1. Check the connected Sunport and list accessible agents.
2. Keep the user's named or previously selected agent when it is available.
`list_agents` returns `id`, `display_name` and `status`; use the selected
returned `id` as the `agent_id` input. Do not invent abilities or rankings.
Ask for a choice when several agents are available and none is selected.
3. Send the requested task once. Save its returned conversation and task IDs.
4. For hosted MCP, use `get_result` with those IDs to check status and read the
result. Never resend the task to check it.
5. Send a requested MCP follow-up with the existing `thread_id`, then check the
**new `run_id`** returned for that follow-up. Preserve the same conversation.
A wait timeout does not cancel the task or prove it failed or stopped. Check an
accepted task using its returned IDs. If acceptance is uncertain because no IDs
were returned, say so rather than resending automatically. Report running,
failed or aborted states accurately; never invent an agent, result or completed
action. Work an agent hands on to a busy agent waits for it and runs even after
the reply that handed i
Preview of the first 4,000 characters. Read full instructions →
Referenced files: 2 — file references are metadata, not package contents.
