Actions Schema Reference

Auto-Generated Documentation

This page is automatically generated from the HMS JSON Schema to ensure it always matches the current specification. It shows all available action types and their IDE mappings. For a human-friendly guide with examples, see Actions Overview.

Available Actions

Hydra supports 32 standard actions that map to different IDE capabilities.

Action	Description	Claude	Cursor	Codex
`code_agent`		-	-	-
`research_agent`		-	-	-
`planning_agent`		-	-	-
`review_agent`		-	-	-
`test_agent`		-	-	-
`docs_agent`		-	-	-
`custom_agent`		-	-	-
`github_integration`		-	-	-
`slack_integration`		-	-	-
`notion_integration`		-	-	-
`jira_integration`		-	-	-
`linear_integration`		-	-	-
`database_integration`		-	-	-
`api_integration`		-	-	-
`webhook_integration`		-	-	-
`file_read`		-	-	-
`file_write`		-	-	-
`shell_execute`		-	-	-
`search_codebase`		-	-	-
`condition`		-	-	-
`loop`		-	-	-
`parallel`		-	-	-
`human_input`		-	-	-
`analyze_code`	Read and understand existing code structure, patterns, and issues.	Read, Grep, Glob tools	@codebase, @file mentions	read_file, search_codebase
`edit_file`		-	-	-
`edit_files`	Modify existing files with targeted changes.	Edit tool	Inline diff	edit_file function
`generate_code`	Create new code files from specifications.	Write tool	Composer auto-apply	write_file function
`generate_tests`	Create test files for existing code.	Write tool	Test generation	write_file function
`execute_command`	Run shell commands (build, test, lint).	Bash tool	Terminal integration	run_command function
`search_references`		-	-	-
`design_architecture`	Plan system architecture, component relationships, and data flow.	Read + reasoning	Composer planning	Structured output
`review_and_commit`	Review changes and create git commits.	Bash (git)	Source control panel	git_commit function

Action Details

code_agent

No description available.

IDE Mapping:

Claude Code: -
Cursor: -
Codex: -

Example:

{
  "id": "step_code_agent",
  "name": "Example code agent",
  "action": "code_agent",
  "parameters": {
    "focus": "specific focus for this action"
  }
}

research_agent

No description available.

IDE Mapping:

Claude Code: -
Cursor: -
Codex: -

Example:

{
  "id": "step_research_agent",
  "name": "Example research agent",
  "action": "research_agent",
  "parameters": {
    "focus": "specific focus for this action"
  }
}

planning_agent

No description available.

IDE Mapping:

Claude Code: -
Cursor: -
Codex: -

Example:

{
  "id": "step_planning_agent",
  "name": "Example planning agent",
  "action": "planning_agent",
  "parameters": {
    "focus": "specific focus for this action"
  }
}

review_agent

No description available.

IDE Mapping:

Claude Code: -
Cursor: -
Codex: -

Example:

{
  "id": "step_review_agent",
  "name": "Example review agent",
  "action": "review_agent",
  "parameters": {
    "focus": "specific focus for this action"
  }
}

test_agent

No description available.

IDE Mapping:

Claude Code: -
Cursor: -
Codex: -

Example:

{
  "id": "step_test_agent",
  "name": "Example test agent",
  "action": "test_agent",
  "parameters": {
    "focus": "specific focus for this action"
  }
}

docs_agent

No description available.

IDE Mapping:

Claude Code: -
Cursor: -
Codex: -

Example:

{
  "id": "step_docs_agent",
  "name": "Example docs agent",
  "action": "docs_agent",
  "parameters": {
    "focus": "specific focus for this action"
  }
}

custom_agent

No description available.

IDE Mapping:

Claude Code: -
Cursor: -
Codex: -

Example:

{
  "id": "step_custom_agent",
  "name": "Example custom agent",
  "action": "custom_agent",
  "parameters": {
    "focus": "specific focus for this action"
  }
}

github_integration

No description available.

IDE Mapping:

Claude Code: -
Cursor: -
Codex: -

Example:

{
  "id": "step_github_integration",
  "name": "Example github integration",
  "action": "github_integration",
  "parameters": {
    "focus": "specific focus for this action"
  }
}

slack_integration

No description available.

IDE Mapping:

Claude Code: -
Cursor: -
Codex: -

Example:

{
  "id": "step_slack_integration",
  "name": "Example slack integration",
  "action": "slack_integration",
  "parameters": {
    "focus": "specific focus for this action"
  }
}

notion_integration

No description available.

IDE Mapping:

Claude Code: -
Cursor: -
Codex: -

Example:

{
  "id": "step_notion_integration",
  "name": "Example notion integration",
  "action": "notion_integration",
  "parameters": {
    "focus": "specific focus for this action"
  }
}

jira_integration

No description available.

IDE Mapping:

Claude Code: -
Cursor: -
Codex: -

Example:

{
  "id": "step_jira_integration",
  "name": "Example jira integration",
  "action": "jira_integration",
  "parameters": {
    "focus": "specific focus for this action"
  }
}

linear_integration

No description available.

IDE Mapping:

Claude Code: -
Cursor: -
Codex: -

Example:

{
  "id": "step_linear_integration",
  "name": "Example linear integration",
  "action": "linear_integration",
  "parameters": {
    "focus": "specific focus for this action"
  }
}

database_integration

No description available.

IDE Mapping:

Claude Code: -
Cursor: -
Codex: -

Example:

{
  "id": "step_database_integration",
  "name": "Example database integration",
  "action": "database_integration",
  "parameters": {
    "focus": "specific focus for this action"
  }
}

api_integration

No description available.

IDE Mapping:

Claude Code: -
Cursor: -
Codex: -

Example:

{
  "id": "step_api_integration",
  "name": "Example api integration",
  "action": "api_integration",
  "parameters": {
    "focus": "specific focus for this action"
  }
}

webhook_integration

No description available.

IDE Mapping:

Claude Code: -
Cursor: -
Codex: -

Example:

{
  "id": "step_webhook_integration",
  "name": "Example webhook integration",
  "action": "webhook_integration",
  "parameters": {
    "focus": "specific focus for this action"
  }
}

file_read

No description available.

IDE Mapping:

Claude Code: -
Cursor: -
Codex: -

Example:

{
  "id": "step_file_read",
  "name": "Example file read",
  "action": "file_read",
  "parameters": {
    "focus": "specific focus for this action"
  }
}

file_write

No description available.

IDE Mapping:

Claude Code: -
Cursor: -
Codex: -

Example:

{
  "id": "step_file_write",
  "name": "Example file write",
  "action": "file_write",
  "parameters": {
    "focus": "specific focus for this action"
  }
}

shell_execute

No description available.

IDE Mapping:

Claude Code: -
Cursor: -
Codex: -

Example:

{
  "id": "step_shell_execute",
  "name": "Example shell execute",
  "action": "shell_execute",
  "parameters": {
    "focus": "specific focus for this action"
  }
}

search_codebase

No description available.

IDE Mapping:

Claude Code: -
Cursor: -
Codex: -

Example:

{
  "id": "step_search_codebase",
  "name": "Example search codebase",
  "action": "search_codebase",
  "parameters": {
    "focus": "specific focus for this action"
  }
}

condition

No description available.

IDE Mapping:

Claude Code: -
Cursor: -
Codex: -

Example:

{
  "id": "step_condition",
  "name": "Example condition",
  "action": "condition",
  "parameters": {
    "focus": "specific focus for this action"
  }
}

loop

No description available.

IDE Mapping:

Claude Code: -
Cursor: -
Codex: -

Example:

{
  "id": "step_loop",
  "name": "Example loop",
  "action": "loop",
  "parameters": {
    "focus": "specific focus for this action"
  }
}

parallel

No description available.

IDE Mapping:

Claude Code: -
Cursor: -
Codex: -

Example:

{
  "id": "step_parallel",
  "name": "Example parallel",
  "action": "parallel",
  "parameters": {
    "focus": "specific focus for this action"
  }
}

human_input

No description available.

IDE Mapping:

Claude Code: -
Cursor: -
Codex: -

Example:

{
  "id": "step_human_input",
  "name": "Example human input",
  "action": "human_input",
  "parameters": {
    "focus": "specific focus for this action"
  }
}

analyze_code

Read and understand existing code structure, patterns, and issues.

IDE Mapping:

Claude Code: Read, Grep, Glob tools
Cursor: @codebase, @file mentions
Codex: read_file, search_codebase

Example:

{
  "id": "step_analyze_code",
  "name": "Example analyze code",
  "action": "analyze_code",
  "parameters": {
    "focus": "specific focus for this action"
  }
}

edit_file

No description available.

IDE Mapping:

Claude Code: -
Cursor: -
Codex: -

Example:

{
  "id": "step_edit_file",
  "name": "Example edit file",
  "action": "edit_file",
  "parameters": {
    "focus": "specific focus for this action"
  }
}

edit_files

Modify existing files with targeted changes.

IDE Mapping:

Claude Code: Edit tool
Cursor: Inline diff
Codex: edit_file function

Example:

{
  "id": "step_edit_files",
  "name": "Example edit files",
  "action": "edit_files",
  "parameters": {
    "focus": "specific focus for this action"
  }
}

generate_code

Create new code files from specifications.

IDE Mapping:

Claude Code: Write tool
Cursor: Composer auto-apply
Codex: write_file function

Example:

{
  "id": "step_generate_code",
  "name": "Example generate code",
  "action": "generate_code",
  "parameters": {
    "focus": "specific focus for this action"
  }
}

generate_tests

Create test files for existing code.

IDE Mapping:

Claude Code: Write tool
Cursor: Test generation
Codex: write_file function

Example:

{
  "id": "step_generate_tests",
  "name": "Example generate tests",
  "action": "generate_tests",
  "parameters": {
    "focus": "specific focus for this action"
  }
}

execute_command

Run shell commands (build, test, lint).

IDE Mapping:

Claude Code: Bash tool
Cursor: Terminal integration
Codex: run_command function

Example:

{
  "id": "step_execute_command",
  "name": "Example execute command",
  "action": "execute_command",
  "parameters": {
    "focus": "specific focus for this action"
  }
}

search_references

No description available.

IDE Mapping:

Claude Code: -
Cursor: -
Codex: -

Example:

{
  "id": "step_search_references",
  "name": "Example search references",
  "action": "search_references",
  "parameters": {
    "focus": "specific focus for this action"
  }
}

design_architecture

Plan system architecture, component relationships, and data flow.

IDE Mapping:

Claude Code: Read + reasoning
Cursor: Composer planning
Codex: Structured output

Example:

{
  "id": "step_design_architecture",
  "name": "Example design architecture",
  "action": "design_architecture",
  "parameters": {
    "focus": "specific focus for this action"
  }
}

review_and_commit

Review changes and create git commits.

IDE Mapping:

Claude Code: Bash (git)
Cursor: Source control panel
Codex: git_commit function

Example:

{
  "id": "step_review_and_commit",
  "name": "Example review and commit",
  "action": "review_and_commit",
  "parameters": {
    "focus": "specific focus for this action"
  }
}

Actions Overview Adapters Reference