hr
Ashby CLI for Headless Automation
Use the Ashby CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.
7 functions 7 read 0 write Bearer token auth
Ashby CLI for Headless Automation
Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.
Use headless automation when another tool needs a stable local command surface. The Ashby CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# Ashby CLI for Headless Automation
kosmokrator integrations:configure ashby --set access_token="$ASHBY_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmo integrations:call ashby.ashby_get_application '{"id":"example_id"}' --json Discovery Before Execution
Agents and scripts can inspect Ashby docs and schemas before choosing a function.
kosmo integrations:docs ashby --json
kosmo integrations:docs ashby.ashby_get_application --json
kosmo integrations:schema ashby.ashby_get_application --json
kosmo integrations:search "Ashby" --json
kosmo integrations:list --json Useful Ashby CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
ashby.ashby_get_application | Read | id | Get detailed information about a specific job application in Ashby, including candidate details, status, and evaluation data. |
ashby.ashby_get_current_user | Read | none | Get the profile of the currently authenticated Ashby user. Use this to verify API access and see user details. |
ashby.ashby_get_interview | Read | id | Get detailed information about a specific interview in Ashby, including scheduled time, interviewers, feedback, and scorecards. |
ashby.ashby_get_job | Read | id | Get detailed information about a specific job in Ashby, including full description, requirements, compensation, and hiring team. |
ashby.ashby_list_applications | Read | limit, offset, job_id, status | List job applications in Ashby. Returns applications with candidate info, status, and associated job. Use filters to narrow by job or status. |
ashby.ashby_list_interviews | Read | limit, offset, application_id | List scheduled interviews in Ashby. Returns interview details with date, time, interviewers, and associated application. Filter by application to see interviews for a specific candidate. |
ashby.ashby_list_jobs | Read | limit, offset, status | List job postings in Ashby. Returns open and closed positions with department, location, and application count. Filter by status to find active openings. |
Automation Notes
- Use
--jsonfor machine-readable output. - Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
- Configure read/write policy before unattended runs; use
--forceonly for trusted automation. - Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.