DXC AI Tools

Terminal dashboards for GitHub PR review and Jira subtask workflows with a real client/server split:

• apps/client: Ink chat UI
• apps/server: agent orchestration, tool execution, OpenRouter, GitHub actions
• packages/shared: shared contracts and event types

What It Does

• Streams user / agent chat in the terminal
• Runs agent logic on the server side, not in the UI
• Uses only defined tools for file search, file read, directory inspection, web lookup, diff parsing, and GitHub PR review
• Can review GitHub PRs and optionally submit inline review comments when GITHUB_TOKEN is configured
• Can generate Jira subtasks from assigned tickets when Jira credentials are configured
• Requires OPENROUTER_API_KEY for AI workflows

Workspace Layout

apps/
  client/
    src/
  server/
    src/
packages/
  shared/
    src/
tests/

Install From npm

Requires Node.js 22.15.0 or newer.

npm install -g dxc-ai-tools

After global install, run the CLI directly:

dxc --git

dxc --jira

Do not run it with npm run dxc unless your current project has its own dxc script. npm run executes scripts from the current folder's package.json; it does not launch globally installed npm CLIs.

One-time usage without global install:

npx -y dxc-ai-tools --git

npx -y dxc-ai-tools --jira

If required credentials are missing, the CLI prompts for them and saves them to .env in the current workspace.

Git Bash On Windows

If npm install -g dxc-ai-tools succeeds but Git Bash says dxc: command not found, add npm's global bin folder to your Git Bash PATH:

export PATH="$PATH:/c/Users/afoud/AppData/Roaming/npm"
dxc --git

To make that permanent:

echo 'export PATH="$PATH:/c/Users/afoud/AppData/Roaming/npm"' >> ~/.bashrc
source ~/.bashrc

You can also run the generated npm shim directly:

/c/Users/afoud/AppData/Roaming/npm/dxc --git

On other machines, check the global npm folder with:

npm prefix -g

Usage

GitHub PR review dashboard:

dxc --git

Jira subtask dashboard:

dxc --jira

Environment

Create .env from .env.example.

Important values:

• OPENROUTER_API_KEY: required for AI workflows
• MODEL: defaults to nvidia/nemotron-3-super-120b-a12b:free
• GITHUB_TOKEN: required for the GitHub dashboard
• JIRA_BASE_URL, JIRA_EMAIL, JIRA_API_TOKEN: required for the Jira dashboard
• ALLOW_SHELL: keeps shell execution disabled by default

Architecture Summary

• The Ink client posts chat prompts to the local backend over HTTP.
• The backend runs orchestration and tools, then streams AppEvents back over SSE.
• Shared contracts live in packages/shared/src. See ARCHITECTURE.md.

Tooling

Available tools currently include:

• directory_tree
• file_read
• file_search
• github_diff_adapter
• github_pr_fetch
• github_pr_review_submit
• web_search
• shell_command

GitHub PR Review

dxc --git

Jira Subtasks

dxc --jira

Local Development

npm install
npm run dev

Client-only entry:

npm run dev:client

Server-only entry:

npm run dev:server

Production build:

npm run build
npm run start

Testing

npm test

Notes

• The active architecture is now apps/client + apps/server + packages/shared.