Skip to main content

​
Usage

archal clone <subcommand>
Run archal clone with no subcommand to see the clone catalog.

​
Subcommands

​
tools

List the MCP tools a clone exposes without starting a session. 
archal clone tools github
archal clone tools github --json

​
start

Start a hosted clone session that stays alive between runs. 
archal clone start github jira
archal clone start --all
OptionDescription
--allStart all available clones
--seed <seeds...>Preload named seeds (e.g. --seed github:enterprise-repo stripe:small-business). Variadic.
--seed-file <path>Load a JSON or markdown seed file into the first clone after startup
--setup <text>Describe desired state in plain English (seeds the first clone)
--setup-file <path>Read setup description from a file
--name <name>Custom session name shown on the dashboard
--ttl-seconds <n>Request a longer session lifetime (capped server-side)
--freshAlways create a new session, even if a recent one matches
Clone sessions stay alive for 30 minutes of inactivity. Use archal clone renew to extend.

​
status

Show the active session, health, and API base URLs. 
archal clone status
archal clone status --json

​
list

List active hosted clone sessions for the current user. 
archal clone list
archal clone list --json

​
autoloop

Use an existing hosted session as the local active session. 
archal clone autoloop <session-id>

​
renew

Extend the active session lifetime. Defaults to 1 hour if no duration is given. 
archal clone renew
archal clone renew 7200

​
seed

Load state into a running clone. 
archal clone seed github enterprise-repo          # named seed
archal clone seed github --file seed.json         # JSON seed file
archal clone seed github --file seed.md           # markdown seed description

​
reset

Reset one or all clones to a clean state. 
archal clone reset github   # reset one clone
archal clone reset          # reset all clones in the session

​
stop

Tear down the active session and print usage stats. 
archal clone stop

​
Using the returned URLs

archal clone start prints API base URLs you can use directly in your code: 
import { Octokit } from '@octokit/rest';

const github = new Octokit({
  baseUrl: 'https://<session>.clones.archal.ai/github/api',
  auth: 'ghp_AaBbCcDdEeFfGgHhIiJjKkLlMmNnOoPpQqRrSsTt',
});

import stripe

stripe.api_key = "sk_live_51Abc123DefGhiJklMnoPqrStUvWxYz0123456789"
stripe.api_base = "https://<session>.clones.archal.ai/stripe/api"
If you call clone endpoints from curl, a Lambda, or a worker instead of the Archal CLI, use the dual-header pattern in Direct API access.