Build a Solution

Build a Solution when you have an agent setup that works and want to install the same setup again for another team or customer.

Before you start

Use a real task to test the agent before you package it. Confirm that its tools, routines, skills, scripts, workflows, and required connections are the ones you intend to distribute.

Packaging Solutions from the portal requires an organization admin.

Package an existing agent

The shortest path is in the portal:

1. Open Settings → Solutions.
2. Choose Package agent.
3. Select the agent.
4. Enter the Solution name, description, and version.
5. Review the dependencies that will be included, then package it.

The resulting Solution belongs to your organization and appears in its Solutions catalog. It is not added to the public marketplace automatically.

Build from files

Use the CLI when you want to review and version the bundle as files:

archagent create solution <slug>
cd <slug>
archagent validate solution
archagent lint solution
archagent package solution . --output-dir dist

validate checks the bundle before packaging. lint reports advisory warnings. package creates a versioned archive in dist.

Import the archive into your organization to test the install path:

archagent import solution ./dist/<slug>-<version>.tar.gz

Test the package

Test the packaged artifact, not only the source agent:

1. Import the archive into a test organization you control.
2. Install its agent template.
3. Complete each required connection or credential step.
4. Run the same real task you used before packaging.
5. Confirm the installed agent does not depend on private data or credentials from the source organization.

Share it

Organization Solutions stay private to that organization. Public marketplace listing is currently curated. Email hi@archastro.ai with the packaged Solution or its name in your organization.

Next steps

• Solutions reference
• Deploy a Solution to a customer
• Configs