genome

Manage Genome versions — automated site analysis that discovers your site structure, generates tracking plans, and produces configuration suggestions.

Commands

actionxm genome create

Create a new genome version (triggers site analysis).

actionxm genome create
actionxm genome create --site <site-id>
actionxm genome create --version "v2.0"
actionxm genome create --scope /products /checkout /pricing

Options:

Option	Description
--site <site-id>	Project/site ID (defaults to current project)
--version <name>	Custom version name (default: auto-incremented)
--scope <urls...>	Restrict analysis to specific relative URLs

actionxm genome list

List all genome versions for a project.

actionxm genome list
actionxm genome list --site <site-id> --limit 10

Options:

Option	Description
--site <site-id>	Project/site ID
--limit <n>	Number of versions to show (default: 20)

Output columns: VERSION, STATE, TRIGGER, PAGES, TOKENS, CREATED

actionxm genome status

Show the most recent genome version status with detailed progress.

actionxm genome status
actionxm genome status --site <site-id>

Displays: version label, state, current stage (if in-progress), progress percentage, trigger, pages analyzed, SDK detection, tokens used, and timestamps.

actionxm genome remove

Delete a genome version.

actionxm genome remove --version v1.0

Options:

Option	Description
--site <site-id>	Project/site ID
--version <v>	(required) Version label to delete

actionxm genome cancel

Cancel an in-progress genome version.

actionxm genome cancel --version v2.0

Options:

Option	Description
--site <site-id>	Project/site ID
--version <v>	(required) Version label to cancel

Summary Subcommands

actionxm genome summary view

View the generated genome summary as markdown.

actionxm genome summary view --version v1.0

Only available for completed versions. In-progress or failed versions show a status message instead.

actionxm genome summary edit

Override a genome summary with a local markdown file.

actionxm genome summary edit --version v1.0 --file summary.md

Options:

Option	Description
--site <site-id>	Project/site ID
--version <v>	(required) Version label
--file <path>	(required) Path to markdown file

Suggestion Subcommands

actionxm genome suggestion view

View the generated configuration suggestions (event rules, action rules, audiences, labels).

actionxm genome suggestion view --version v1.0

Output is either structured JSON (R5+ format) or legacy markdown, depending on the genome version.

actionxm genome suggestion apply

Apply the generated suggestions to your project configuration.

actionxm genome suggestion apply --version v1.0

Creates event rules, action rules, audiences, and labels in your project based on the genome analysis. Shows a summary of items created by type.

Workflow Example

# 1. Start a genome analysis
actionxm genome create --site <site-id>

# 2. Monitor progress
actionxm genome status

# 3. Review results
actionxm genome summary view --version v1.0
actionxm genome suggestion view --version v1.0

# 4. Apply suggestions to project
actionxm genome suggestion apply --version v1.0