Skip to main content

jjhub

jjhub agent

Talk to the local JJHub usage helper. By default, both jjhub and jjhub agent run locally, auto-detect the current jj repo, gather JJ/JJHub startup context, and use JJHub docs retrieval instead of stuffing the full docs corpus into every turn. Run them with a one-shot prompt or with no prompt for interactive use.

Arguments

NameTypeRequiredDescription
promptstringnoOptional one-shot prompt for the local JJHub helper

Options

FlagTypeDefaultDescription
--sandboxbooleanfalseUse the workspace-backed sandbox backend instead of direct local execution
--repostringOverride the detected repository slug (OWNER/REPO)

jjhub agent session

Manage remote JJHub agent sessions. Legacy compatibility aliases remain available: jjhub agent list, jjhub agent view, jjhub agent run, and jjhub agent chat.

jjhub agent session chat

Send a message to an existing remote agent session

Arguments

NameTypeRequiredDescription
idstringyesSession ID
messagestringyesMessage to send

Options

FlagTypeDefaultDescription
--repostringRepository (OWNER/REPO)

jjhub agent session list

List remote agent sessions

Options

FlagTypeDefaultDescription
--pagenumber1Page number
--per-pagenumber30Results per page
--repostringRepository (OWNER/REPO)

jjhub agent session run

Start a new remote agent session and run a prompt

Arguments

NameTypeRequiredDescription
promptstringyesPrompt to send to the remote agent

Options

FlagTypeDefaultDescription
--titlestringOptional title for the session
--repostringRepository (OWNER/REPO)

jjhub agent session view

View a remote agent session

Arguments

NameTypeRequiredDescription
idstringyesSession ID

Options

FlagTypeDefaultDescription
--repostringRepository (OWNER/REPO)

jjhub api

jjhub api

Make raw API calls to the JJHub server

Arguments

NameTypeRequiredDescription
endpointstringyesAPI endpoint path (e.g. /repos/owner/name)

Options

FlagTypeDefaultDescription
--methodstringGETHTTP method
--fieldarrayRequest body field (key=value)
--headerarrayRequest header (key:value)

jjhub artifact

Manage workflow artifacts

jjhub artifact download

Download an artifact from a workflow run

Arguments

NameTypeRequiredDescription
runIdnumberyesWorkflow run ID
namestringyesArtifact name

Options

FlagTypeDefaultDescription
--outputstringOutput file path
--repostringRepository (OWNER/REPO)

jjhub artifact list

List artifacts for a workflow run

Arguments

NameTypeRequiredDescription
runIdnumberyesWorkflow run ID

Options

FlagTypeDefaultDescription
--repostringRepository (OWNER/REPO)

jjhub auth

Manage authentication (login, logout, token)

jjhub auth login

Log in to JJHub

Options

FlagTypeDefaultDescription
--with-tokenbooleanfalseRead token from stdin instead of browser flow
--hostnamestringAPI hostname to authenticate with

jjhub auth logout

Log out of JJHub

Options

FlagTypeDefaultDescription
--hostnamestringHostname to log out from

jjhub auth status

Show authentication status

jjhub auth token

Print the authentication token

jjhub beta

Manage closed alpha whitelist and waitlist

jjhub beta waitlist approve

Approve a waitlist entry by email (admin)

Options

FlagTypeDefaultDescription
--emailstringEmail to approve

jjhub beta waitlist join

Join the closed alpha waitlist

Options

FlagTypeDefaultDescription
--emailstringEmail to submit
--notestringOptional note for admins
--sourcestringcliSource tag

jjhub beta waitlist list

List waitlist entries (admin)

Options

FlagTypeDefaultDescription
--statusstringFilter by status (pending, approved, rejected)
--limitnumber30Maximum number of results (max 100)

jjhub beta whitelist add

Add or update a whitelist entry (admin)

Options

FlagTypeDefaultDescription
--typestringIdentity type: email, wallet, username
--valuestringIdentity value

jjhub beta whitelist list

List whitelist entries (admin)

jjhub beta whitelist remove

Remove a whitelist entry (admin)

Options

FlagTypeDefaultDescription
--typestringIdentity type: email, wallet, username
--valuestringIdentity value

jjhub bookmark

Manage bookmarks (branches)

jjhub bookmark create

Create a bookmark

Arguments

NameTypeRequiredDescription
namestringyesBookmark name

Options

FlagTypeDefaultDescription
--changestringTarget change ID
--repostringRepository (OWNER/REPO)

jjhub bookmark delete

Delete a bookmark

Arguments

NameTypeRequiredDescription
namestringyesBookmark name

Options

FlagTypeDefaultDescription
--repostringRepository (OWNER/REPO)

jjhub bookmark list

List bookmarks

Options

FlagTypeDefaultDescription
--repostringRepository (OWNER/REPO)

jjhub cache

Manage workflow caches

jjhub cache clear

Clear all caches for a repository

Options

FlagTypeDefaultDescription
--bookmarkstringFilter by bookmark name
--keystringFilter by cache key
--repostringRepository (OWNER/REPO)

jjhub cache list

List all caches for a repository

Options

FlagTypeDefaultDescription
--bookmarkstringFilter by bookmark name
--keystringFilter by cache key
--limitnumber30Results per page
--pagenumber1Page number
--repostringRepository (OWNER/REPO)

jjhub cache stats

Show cache statistics for a repository

Options

FlagTypeDefaultDescription
--repostringRepository (OWNER/REPO)

jjhub change

View changes

jjhub change diff

Show diff for a change

Arguments

NameTypeRequiredDescription
idstringnoChange ID (defaults to working copy)

Options

FlagTypeDefaultDescription
--repostringRepository (OWNER/REPO)

jjhub change list

List changes

Options

FlagTypeDefaultDescription
--limitnumber10Number of changes to show
--repostringRepository (OWNER/REPO)

jjhub change show

Show a specific change

Arguments

NameTypeRequiredDescription
idstringyesChange ID

Options

FlagTypeDefaultDescription
--repostringRepository (OWNER/REPO)

jjhub completion

jjhub completion

Generate shell completions

Arguments

NameTypeRequiredDescription
shellstringyesShell type

jjhub config

Get and set configuration

jjhub config get

Get a config value by key

Arguments

NameTypeRequiredDescription
keystringyesConfig key (api_url, git_protocol)

jjhub config list

List all config values

jjhub config set

Set a config value by key

Arguments

NameTypeRequiredDescription
keystringyesConfig key (api_url, git_protocol)
valuestringyesValue to set

jjhub extension

Configure built-in integrations from the CLI

jjhub extension linear

Configure and manage the Linear integration Use the UI at /integrations/linear when you want JJHub to drive the OAuth flow, or use these CLI commands when you already have the Linear team metadata and tokens.

jjhub extension linear install

Configure a Linear team for a JJHub repository

Options

FlagTypeDefaultDescription
--team-idstringLinear team ID
--team-namestringLinear team display name
--team-keystringLinear team key (for example PLT)
--repo-ownerstringJJHub repo owner
--repo-namestringJJHub repo name
--repo-idnumberJJHub repo ID
--credentials-stdinbooleanfalseRead Linear OAuth credentials from stdin as JSON
--expires-atstringToken expiry timestamp (ISO-8601)
--actor-idstringLinear actor ID for loop-guard filtering

jjhub extension linear list

List configured Linear integrations

jjhub extension linear remove

Remove a Linear integration

Arguments

NameTypeRequiredDescription
idnumberyesIntegration ID

jjhub extension linear sync

Trigger the initial sync for a Linear integration

Arguments

NameTypeRequiredDescription
idnumberyesIntegration ID

jjhub issue

Manage issues

jjhub issue close

Close an issue

Arguments

NameTypeRequiredDescription
numbernumberyesIssue number

Options

FlagTypeDefaultDescription
--commentstringAdd a comment when closing
--repostringRepository (OWNER/REPO)

jjhub issue create

Create an issue

Arguments

NameTypeRequiredDescription
titlestringyesIssue title

Options

FlagTypeDefaultDescription
--bodystringIssue body
--assigneestringAssignee username
--repostringRepository (OWNER/REPO)

jjhub issue list

List issues

Options

FlagTypeDefaultDescription
--statestringopenFilter by state
--limitnumber30Maximum number of results (max 100)
--repostringRepository (OWNER/REPO)

jjhub issue reopen

Reopen an issue

Arguments

NameTypeRequiredDescription
numbernumberyesIssue number

Options

FlagTypeDefaultDescription
--repostringRepository (OWNER/REPO)

jjhub issue view

View an issue

Arguments

NameTypeRequiredDescription
numbernumberyesIssue number

Options

FlagTypeDefaultDescription
--repostringRepository (OWNER/REPO)

jjhub label

Manage labels

jjhub label create

Create a label

Arguments

NameTypeRequiredDescription
namestringyesLabel name

Options

FlagTypeDefaultDescription
--colorstringLabel color (hex)
--descriptionstringLabel description
--repostringRepository (OWNER/REPO)

jjhub label delete

Delete a label

Arguments

NameTypeRequiredDescription
idnumberyesLabel ID

Options

FlagTypeDefaultDescription
--repostringRepository (OWNER/REPO)

jjhub label list

List labels

Options

FlagTypeDefaultDescription
--repostringRepository (OWNER/REPO)

jjhub land

Manage landing requests

jjhub land checks

View landing request checks

Arguments

NameTypeRequiredDescription
numbernumberyesLanding request number

Options

FlagTypeDefaultDescription
--repostringRepository (OWNER/REPO)

jjhub land conflicts

View landing request conflicts

Arguments

NameTypeRequiredDescription
numbernumberyesLanding request number

Options

FlagTypeDefaultDescription
--repostringRepository (OWNER/REPO)

jjhub land create

Create a landing request

Options

FlagTypeDefaultDescription
--titlestringLanding request title
--bodystringLanding request body
--targetstringmainTarget bookmark
--changestringChange ID(s) to land
--repostringRepository (OWNER/REPO)

jjhub land land

Land (merge) a landing request

Arguments

NameTypeRequiredDescription
numbernumberyesLanding request number

Options

FlagTypeDefaultDescription
--repostringRepository (OWNER/REPO)

jjhub land list

List landing requests

Options

FlagTypeDefaultDescription
--statestringopenFilter by state
--limitnumber30Maximum number of results (max 100)
--repostringRepository (OWNER/REPO)

jjhub land review

Submit a review on a landing request

Arguments

NameTypeRequiredDescription
numbernumberyesLanding request number

Options

FlagTypeDefaultDescription
--approvebooleanfalseApprove the landing request
--bodystringReview comment
--repostringRepository (OWNER/REPO)

jjhub land view

View a landing request

Arguments

NameTypeRequiredDescription
numbernumberyesLanding request number

Options

FlagTypeDefaultDescription
--repostringRepository (OWNER/REPO)

jjhub notification

Manage notifications

jjhub notification list

List recent notifications

Options

FlagTypeDefaultDescription
--allbooleanfalseInclude read notifications
--limitnumber30Results per page

jjhub notification mark-read

Mark a notification as read

Arguments

NameTypeRequiredDescription
idstringyesNotification ID

jjhub org

Manage organizations and teams

jjhub org create

Create a new organization

Arguments

NameTypeRequiredDescription
namestringyesOrganization name

Options

FlagTypeDefaultDescription
--descriptionstringOrganization description
--visibilitystringpublicVisibility (public, private)

jjhub org delete

Delete an organization

Arguments

NameTypeRequiredDescription
namestringyesOrganization name

jjhub org list

List organizations you belong to

jjhub org member add

Add a user to an organization

Arguments

NameTypeRequiredDescription
orgstringyesOrganization name
usernamestringyesUsername to add

jjhub org member list

List organization members

Arguments

NameTypeRequiredDescription
orgstringyesOrganization name

jjhub org member remove

Remove a user from an organization

Arguments

NameTypeRequiredDescription
orgstringyesOrganization name
usernamestringyesUsername to remove

jjhub org team create

Create a team in an organization

Arguments

NameTypeRequiredDescription
orgstringyesOrganization name
namestringyesTeam name

Options

FlagTypeDefaultDescription
--descriptionstringTeam description
--permissionstringreadDefault permission (read, write, admin)

jjhub org team delete

Delete a team

Arguments

NameTypeRequiredDescription
orgstringyesOrganization name
teamstringyesTeam slug

jjhub org team list

List teams in an organization

Arguments

NameTypeRequiredDescription
orgstringyesOrganization name

jjhub org team member add

Add a user to a team

Arguments

NameTypeRequiredDescription
orgstringyesOrganization name
teamstringyesTeam slug
usernamestringyesUsername to add

jjhub org team member list

List team members

Arguments

NameTypeRequiredDescription
orgstringyesOrganization name
teamstringyesTeam slug

jjhub org team member remove

Remove a user from a team

Arguments

NameTypeRequiredDescription
orgstringyesOrganization name
teamstringyesTeam slug
usernamestringyesUsername to remove

jjhub org team repo add

Grant a team access to a repository

Arguments

NameTypeRequiredDescription
orgstringyesOrganization name
teamstringyesTeam slug
repostringyesRepository (OWNER/REPO)

jjhub org team repo list

List repositories a team has access to

Arguments

NameTypeRequiredDescription
orgstringyesOrganization name
teamstringyesTeam slug

jjhub org team repo remove

Remove repository access from a team

Arguments

NameTypeRequiredDescription
orgstringyesOrganization name
teamstringyesTeam slug
repostringyesRepository (OWNER/REPO)

jjhub org view

View organization details

Arguments

NameTypeRequiredDescription
namestringyesOrganization name

jjhub repo

Manage repositories

jjhub repo clone

Clone a repository

Arguments

NameTypeRequiredDescription
repostringyesRepository in OWNER/REPO format or URL

Options

FlagTypeDefaultDescription
--directorystringTarget directory
--protocolstringGit protocol to use

jjhub repo create

Create a new repository

Arguments

NameTypeRequiredDescription
namestringyesRepository name

Options

FlagTypeDefaultDescription
--descriptionstringRepository description
--privatebooleanfalseMake repository private

jjhub repo list

List your repositories

Options

FlagTypeDefaultDescription
--limitnumber30Maximum number of results (max 100)

jjhub repo view

View repository details

Arguments

NameTypeRequiredDescription
repostringyesRepository in OWNER/REPO format

jjhub run

View and manage workflow runs

jjhub run list

List workflow runs

Options

FlagTypeDefaultDescription
--repostringRepository (OWNER/REPO)

jjhub run rerun

Rerun a workflow

Arguments

NameTypeRequiredDescription
idnumberyesRun ID

Options

FlagTypeDefaultDescription
--repostringRepository (OWNER/REPO)

jjhub run view

View a workflow run

Arguments

NameTypeRequiredDescription
idnumberyesRun ID

Options

FlagTypeDefaultDescription
--repostringRepository (OWNER/REPO)
Search repos, issues, and code

jjhub search code

Search code

Arguments

NameTypeRequiredDescription
querystringyesSearch query

Options

FlagTypeDefaultDescription
--limitnumber30Maximum number of results (max 100)

jjhub search issues

Search issues

Arguments

NameTypeRequiredDescription
querystringyesSearch query

Options

FlagTypeDefaultDescription
--limitnumber30Maximum number of results (max 100)

jjhub search repos

Search repositories

Arguments

NameTypeRequiredDescription
querystringyesSearch query

Options

FlagTypeDefaultDescription
--limitnumber30Maximum number of results (max 100)

jjhub secret

Manage secrets

jjhub secret delete

Delete a secret

Arguments

NameTypeRequiredDescription
namestringyesSecret name

Options

FlagTypeDefaultDescription
--repostringRepository (OWNER/REPO)

jjhub secret list

List secrets

Options

FlagTypeDefaultDescription
--repostringRepository (OWNER/REPO)

jjhub secret set

Set a secret

Arguments

NameTypeRequiredDescription
namestringyesSecret name

Options

FlagTypeDefaultDescription
--body-stdinbooleanfalseRead the secret value from stdin
--repostringRepository (OWNER/REPO)

jjhub ssh-key

Manage SSH keys

jjhub ssh-key add

Add an SSH key

Options

FlagTypeDefaultDescription
--titlestringKey title
--keystringPublic key content

jjhub ssh-key delete

Delete an SSH key

Arguments

NameTypeRequiredDescription
idnumberyesKey ID

jjhub ssh-key list

List SSH keys

jjhub status

jjhub status

Show working copy status

jjhub variable

Manage variables

jjhub variable delete

Delete a variable

Arguments

NameTypeRequiredDescription
namestringyesVariable name

Options

FlagTypeDefaultDescription
--repostringRepository (OWNER/REPO)

jjhub variable get

Get a variable value

Arguments

NameTypeRequiredDescription
namestringyesVariable name

Options

FlagTypeDefaultDescription
--repostringRepository (OWNER/REPO)

jjhub variable list

List variables

Options

FlagTypeDefaultDescription
--repostringRepository (OWNER/REPO)

jjhub variable set

Set a variable

Arguments

NameTypeRequiredDescription
namestringyesVariable name

Options

FlagTypeDefaultDescription
--bodystringVariable value
--repostringRepository (OWNER/REPO)

jjhub webhook

Manage repository webhooks

jjhub webhook create

Create a new webhook

Options

FlagTypeDefaultDescription
--urlstringyesPayload URL
--secret-stdinbooleanfalseRead the HMAC secret from stdin
--eventsstring*Comma-separated event types
--repostringRepository (OWNER/REPO)

jjhub webhook delete

Delete a webhook

Arguments

NameTypeRequiredDescription
idnumberyesWebhook ID

Options

FlagTypeDefaultDescription
--repostringRepository (OWNER/REPO)

jjhub webhook list

List webhooks for a repository

Options

FlagTypeDefaultDescription
--limitnumber30Results per page
--pagenumber1Page number
--repostringRepository (OWNER/REPO)

jjhub wiki

Manage repository wiki pages

jjhub wiki list

List all wiki pages

Options

FlagTypeDefaultDescription
--repostringRepository (OWNER/REPO)

jjhub wiki view

View a wiki page content

Arguments

NameTypeRequiredDescription
namestringyesPage name (e.g. Home)

Options

FlagTypeDefaultDescription
--repostringRepository (OWNER/REPO)

jjhub workflow

Manage workflows

jjhub workflow dispatch

Trigger a workflow

Arguments

NameTypeRequiredDescription
idnumberyesWorkflow ID

Options

FlagTypeDefaultDescription
--refstringmainGit ref to run against
--repostringRepository (OWNER/REPO)

jjhub workflow list

List workflows

Options

FlagTypeDefaultDescription
--repostringRepository (OWNER/REPO)

jjhub workspace

Manage cloud workspaces

jjhub workspace create

Create a workspace

Options

FlagTypeDefaultDescription
--namestringWorkspace name
--snapshotstringSnapshot ID to restore from
--repostringRepository (OWNER/REPO)

jjhub workspace delete

Delete a workspace

Arguments

NameTypeRequiredDescription
idstringyesWorkspace ID

Options

FlagTypeDefaultDescription
--repostringRepository (OWNER/REPO)

jjhub workspace fork

Fork a workspace

Arguments

NameTypeRequiredDescription
idstringyesWorkspace ID to fork

Options

FlagTypeDefaultDescription
--namestringName for the forked workspace
--repostringRepository (OWNER/REPO)

jjhub workspace issue

Spin up a workspace for an issue, open a draft landing request, and connect to the workspace

Arguments

NameTypeRequiredDescription
numberstringyesIssue number to work on

Options

FlagTypeDefaultDescription
--targetstringmainTarget bookmark for the draft landing request
--repostringRepository (OWNER/REPO)

jjhub workspace list

List workspaces

Options

FlagTypeDefaultDescription
--repostringRepository (OWNER/REPO)

jjhub workspace snapshots

List workspace snapshots

Arguments

NameTypeRequiredDescription
idstringyesWorkspace ID

Options

FlagTypeDefaultDescription
--repostringRepository (OWNER/REPO)

jjhub workspace ssh

SSH into a workspace, auto-detecting or creating one for the repository when needed

Arguments

NameTypeRequiredDescription
idstringnoWorkspace ID (auto-detected if omitted)

Options

FlagTypeDefaultDescription
--repostringRepository (OWNER/REPO)

jjhub workspace view

View workspace details (status, SSH info, persistence)

Arguments

NameTypeRequiredDescription
idstringyesWorkspace ID

Options

FlagTypeDefaultDescription
--repostringRepository (OWNER/REPO)

jjhub admin

Manage JJHub instance settings and resources (admin only).

jjhub admin health

Show system health status

jjhub admin runner list

List all registered runners and their current status

jjhub admin user list

List all users in the system

Options

FlagTypeDefaultDescription
--pagenumber1Page number
--limitnumber30Results per page

jjhub admin user create

Create a new user

Options

FlagTypeDefaultDescription
--usernamestringyesUsername
--emailstringyesEmail address
--passwordstringInitial password
--must-change-passwordbooleantrueRequire password change on first login

jjhub admin user disable

Disable a user account

Arguments

NameTypeRequiredDescription
usernamestringyesUsername to disable

jjhub admin user delete

Permanently delete a user account

Arguments

NameTypeRequiredDescription
usernamestringyesUsername to delete

jjhub admin workflow list

List all workflow runs across all repositories

Options

FlagTypeDefaultDescription
--pagenumber1Page number
--limitnumber30Results per page
--statusstringFilter by status (running, success, failure, queued)