nitor 1.4.2 → 1.6.0

package/CHANGELOG.md

@@ -38,3 +38,33 @@ For a complete list of changes and discussion, see [Issue #1](https://github.com
 - Added support for task stats and get task commands.
 
 - [Issue #7](https://github.com/codebynithin/nitor/issues/7)
+
+## [1.5.0] - 2026-04-10
+
+### New Features
+
+- Add table display for get-task command.
+
+- [Issue #9](https://github.com/codebynithin/nitor/issues/9)
+
+## [1.6.0] - 2026-04-20
+
+### New Features
+
+- Added `mr-status` command to list GitLab repositories you contribute to and
+  view their merge requests rendered as a branch tree (with filtering by state
+  and repository search).
+- `task-stats` and `get-task` output now render GitLab issue IDs, merge request
+  IDs, and Zoho task IDs as clickable terminal hyperlinks (OSC 8) for
+  supporting terminals.
+- New env variables `ZOHO_WORKSPACE` and `ZOHO_PROJECT_PREFIX` for building
+  Zoho Sprints task URLs used by the clickable `Task` column.
+
+### Enhancements
+
+- `printTable` is now ANSI/hyperlink-aware and computes visible column widths
+  correctly when cell values contain escape sequences.
+- Autocomplete updated to include the new `mr-status` command and its
+  `-state` / `-search` options.
+
+- [Issue #10](https://github.com/codebynithin/nitor/issues/10)

package/README.md

@@ -29,6 +29,8 @@ A CLI utility toolkit for automating and managing build, deploy, and status oper
 - Task statistics with merge request details
 - Extract Zoho task IDs from GitLab issue descriptions
 - Merge request status tracking for active tasks
+- Branch-tree view of GitLab merge requests across repositories (`mr-status`)
+- Clickable terminal hyperlinks for task IDs, GitLab issues and merge requests in stats output
 
 ## Requirements
 
@@ -57,6 +59,8 @@ A CLI utility toolkit for automating and managing build, deploy, and status oper
   - `ZOHO_TOKEN` - Zoho CSRF token
   - `ZOHO_URI` - Zoho API URL
   - `ZOHO_USERID` - Zoho user ID
+  - `ZOHO_WORKSPACE` - Zoho workspace name (used to build clickable task links)
+  - `ZOHO_PROJECT_PREFIX` - Zoho project prefix, e.g. `P29` (used to build clickable task links)
 
 ## Installation
 
@@ -184,6 +188,18 @@ Once enabled, you can use Tab to autocomplete:
   ```bash
   nitor get-task -task <task numbers with space>
   ```
+- **Merge Request Status (Tree View):**
+
+  ```bash
+  # Interactive: pick a repository, then view MRs as a branch tree
+  nitor mr-status
+
+  # Filter by MR state (opened | merged | closed | all)
+  nitor mr-status -state opened
+
+  # Pre-filter repositories by name
+  nitor mr-status -search <text>
+  ```
 
 ### Command Reference
 
@@ -211,6 +227,7 @@ Once enabled, you can use Tab to autocomplete:
 - `time-switch` : Switch between default projects
 - `task-stats` : View task statistics with GitLab merge request details
 - `get-task` : Extract Zoho task IDs from GitLab issue descriptions
+- `mr-status` : List GitLab repositories you contribute to and view merge requests as a branch tree
 
 ## MongoDB Backup & Restore
 
@@ -359,6 +376,8 @@ The backup service is designed to work on Windows, macOS, and Linux:
 - `-mergeId` or `-mId` : Merge ID
 - `-source` or `-so` : Source branch name
 - `-target` or `-ta` : Target branch name
+- `-state` or `-st` : MR state filter for `mr-status` (`opened`, `merged`, `closed`, `all`)
+- `-search` or `-q` : Repository search text for `mr-status`
 
 #### Time Entry Options
 

package/docs/MR_STATUS.md

@@ -0,0 +1,74 @@
+# mr-status
+
+List GitLab repositories you are a member of, pick one, and view its merge
+requests rendered as a branch tree. Useful for quickly seeing the shape of a
+stacked/chained set of MRs, what targets what, and who owns each one.
+
+## Usage
+
+```bash
+nitor mr-status [-state <opened|merged|closed|all>] [-search <text>]
+nitor mr-status [-st <state>] [-q <text>]
+```
+
+Running `nitor mr-status` with no arguments will:
+
+1. Fetch the repositories you are a member of (ordered by last activity).
+2. Prompt you to pick one by number.
+3. Prompt you to pick an MR state (defaults to `opened`).
+4. Print the selected repository's merge requests grouped by target branch as
+   a tree, showing source → target, state, author, last update time and URL.
+
+## Options
+
+- `-st`, `-state <state>` — MR state filter. One of `opened` (default),
+  `merged`, `closed`, `all`.
+- `-q`, `-search <text>` — Pre-filter the repository list by name before the
+  interactive picker is shown.
+
+## Examples
+
+```bash
+# Fully interactive
+nitor mr-status
+
+# Jump straight to opened MRs after picking a repo
+nitor mr-status -state opened
+
+# Narrow the repo picker to repos whose names contain "portal"
+nitor mr-status -search portal
+
+# Short aliases
+nitor mr-status -st merged -q gateway
+```
+
+## How the tree is built
+
+- MRs are grouped by their `target_branch`.
+- A target branch that is **not** any MR's source branch is treated as a root
+  (e.g. `master`, `development`).
+- For each MR, if its `source_branch` is itself a target of another MR, that
+  MR is nested underneath as a child — producing a readable stack of MRs.
+- Cycles (rare, but possible with odd branch setups) are detected and marked
+  with a `(cycle)` label instead of recursing forever.
+
+## Requirements
+
+The command uses the GitLab REST API and requires the following env vars in
+your `.env.nu`:
+
+- `GITLAB_URI` — e.g. `https://gitlab.com/`
+- `GITLAB_TOKEN` — personal access token with `read_api` scope
+
+If either is missing, the command exits with a clear message.
+
+## Output legend
+
+- `⎇ <branch>` — a target branch heading with the number of MRs targeting it
+- `!<iid> <title>` — the merge request, colored by state:
+  - green: `opened`
+  - blue: `merged`
+  - red: `closed`
+- `[draft]` — shown when the MR is a draft / WIP
+- Second line: `source → target  [state]  author  updated_at`
+- Third line: the MR web URL (clickable in most modern terminals)

package/docs/README.md

@@ -54,6 +54,10 @@ nitor <command> -help
 
 - **[backup](./BACKUP.md)** - MongoDB database backups
 
+### GitLab Insights
+
+- **[mr-status](./MR_STATUS.md)** - List GitLab repositories you contribute to and view merge requests as a branch tree
+
 ### Time Entry Commands
 
 - **[time-entry](./TIME_ENTRY.md)** - Complete time tracking and management guide

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nitor",
-  "version": "1.4.2",
+  "version": "1.6.0",
   "description": "A comprehensive CLI toolkit for automating GitLab operations, AI-powered code review, build/deploy automation, MongoDB backup/restore, and developer productivity tools",
   "main": "index.js",
   "author": "Nithin V <mails2nithin@gmail.com>",

package/services/autocomplete.js

@@ -228,6 +228,14 @@ const setupAutocomplete = () => {
       '-help': [],
       '--h': [],
     },
+    [ACTIONS.MR_STATUS]: {
+      '-state': ['opened', 'merged', 'closed', 'all'],
+      '-st': ['opened', 'merged', 'closed', 'all'],
+      '-search': [],
+      '-q': [],
+      '-help': [],
+      '--h': [],
+    },
     [ACTIONS.TIME_INIT]: [],
     [ACTIONS.TIME_SWITCH]: [],
     [ACTIONS.TIME_ADD]: [],

package/services/enums/actions.enum.js

@@ -13,6 +13,7 @@ module.exports = {
     VERSION: 'version',
     TASK_STATS: 'task-stats',
     GET_TASK: 'get-task',
+    MR_STATUS: 'mr-status',
 
     // Time entry commands
     TIME_INIT: 'time-init',

package/services/mr-status.js

@@ -0,0 +1,306 @@
+const axios = require('axios');
+const readline = require('readline');
+const { gitlabConfig, createSpinner } = require('./utils');
+
+const STATES = ['opened', 'merged', 'closed', 'all'];
+
+const C = {
+  reset: '\x1b[0m',
+  bold: '\x1b[1m',
+  dim: '\x1b[2m',
+  cyan: '\x1b[36m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  magenta: '\x1b[35m',
+  blue: '\x1b[34m',
+  red: '\x1b[31m',
+};
+
+const apiBase = () => `${(gitlabConfig.url || '').replace(/\/+$/, '')}/api/v4`;
+
+const gitlabGet = async (path, params = {}) => {
+  const response = await axios.get(`${apiBase()}${path}`, {
+    headers: { 'PRIVATE-TOKEN': gitlabConfig.token },
+    params,
+    timeout: 20000,
+  });
+
+  return response.data;
+};
+
+const fetchProjects = async (search = '') => {
+  return gitlabGet('/projects', {
+    membership: true,
+    order_by: 'last_activity_at',
+    sort: 'desc',
+    per_page: 100,
+    simple: true,
+    search: search || undefined,
+  });
+};
+
+const fetchMergeRequests = async (projectId, state = 'opened') => {
+  return gitlabGet(`/projects/${encodeURIComponent(String(projectId))}/merge_requests`, {
+    state,
+    per_page: 100,
+    order_by: 'updated_at',
+    sort: 'desc',
+    scope: 'all',
+  });
+};
+
+const buildTree = (mrs) => {
+  const byTarget = new Map();
+  const sourceSet = new Set(mrs.map((m) => m.source_branch));
+
+  for (const mr of mrs) {
+    if (!byTarget.has(mr.target_branch)) {
+      byTarget.set(mr.target_branch, []);
+    }
+
+    byTarget.get(mr.target_branch).push(mr);
+  }
+
+  const rootTargets = [...byTarget.keys()].filter((t) => !sourceSet.has(t));
+  const roots = rootTargets.length ? rootTargets : [...byTarget.keys()];
+
+  const buildNode = (branch, visited = new Set()) => {
+    if (visited.has(branch)) {
+      return { branch, mrs: [], cyclic: true };
+    }
+
+    visited.add(branch);
+
+    const list = byTarget.get(branch) || [];
+
+    return {
+      branch,
+      mrs: list.map((mr) => ({
+        mr,
+        child: byTarget.has(mr.source_branch)
+          ? buildNode(mr.source_branch, new Set(visited))
+          : null,
+      })),
+    };
+  };
+
+  return roots.sort().map((b) => buildNode(b));
+};
+
+const stateColor = (state) => {
+  switch (state) {
+    case 'opened':
+      return C.green;
+    case 'merged':
+      return C.blue;
+    case 'closed':
+      return C.red;
+    default:
+      return C.dim;
+  }
+};
+
+const fmtDate = (s) => {
+  if (!s) return '';
+
+  return new Date(s).toISOString().replace('T', ' ').slice(0, 16);
+};
+
+const TREE = {
+  branch: '├── ',
+  lastBranch: '└── ',
+  vertical: '│   ',
+  space: '    ',
+};
+
+// Render tree connectors at normal brightness (not dim) so the hierarchy is
+// clearly visible against the rest of the output.
+const treeStyle = (s) => s;
+
+const printMR = (mr, prefix, connector, continuation) => {
+  const draft = mr.draft || mr.work_in_progress ? ` ${C.yellow}[draft]${C.reset}` : '';
+  const state = `${stateColor(mr.state)}${mr.state}${C.reset}`;
+  const author = mr.author?.name || mr.author?.username || '-';
+  const linePrefix = `${prefix}${treeStyle(continuation)}`;
+
+  console.log(
+    `${prefix}${treeStyle(connector)}${C.cyan}!${mr.iid}${C.reset} ${C.bold}${mr.title}${C.reset}${draft}`,
+  );
+  console.log(
+    `${linePrefix}  ${C.dim}${mr.source_branch} → ${mr.target_branch}${C.reset}  [${state}]  ${C.magenta}${author}${C.reset}  ${C.dim}${fmtDate(mr.updated_at)}${C.reset}`,
+  );
+  console.log(`${linePrefix}  ${C.dim}${mr.web_url}${C.reset}`);
+};
+
+const printBranchNode = (node, prefix = '') => {
+  const count = node.mrs.length;
+  const cyclic = node.cyclic ? ` ${C.yellow}(cycle)${C.reset}` : '';
+
+  console.log(
+    `${prefix}${C.bold}${C.blue}⎇ ${node.branch}${C.reset} ${C.dim}(${count} MR${count === 1 ? '' : 's'})${C.reset}${cyclic}`,
+  );
+
+  node.mrs.forEach(({ mr, child }, idx) => {
+    const isLast = idx === node.mrs.length - 1;
+    const connector = isLast ? TREE.lastBranch : TREE.branch;
+    // When an MR has a child branch, keep the vertical in the continuation so
+    // the child is visibly connected to the MR even if this MR is the last
+    // sibling at its level.
+    const continuation = isLast ? TREE.space : TREE.vertical;
+    // const continuation = isLast && !child ? TREE.space : TREE.vertical;
+
+    printMR(mr, prefix, connector, continuation);
+
+    if (child) {
+      printBranchNode(child, `${prefix}${treeStyle(continuation)}`);
+    }
+  });
+};
+
+const askQuestion = (question) =>
+  new Promise((resolve) => {
+    // terminal: false keeps stdin in cooked mode so the terminal itself handles
+    // echo. Using the default (terminal: true) alongside tooling that tweaks
+    // the TTY (e.g. the spinner's cursor-hide escapes) can cause each typed
+    // character to render twice (e.g. "1" appearing as "11").
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout,
+      terminal: false,
+    });
+
+    process.stdout.write(question);
+
+    rl.question('', (answer) => {
+      rl.close();
+      resolve((answer || '').trim());
+    });
+  });
+
+const selectRepo = async (projects) => {
+  console.log('');
+
+  projects.forEach((p, i) => {
+    console.log(
+      `  ${C.cyan}${String(i + 1).padStart(3)}${C.reset}. ${C.bold}${p.name}${C.reset} ${C.dim}(${p.path_with_namespace})${C.reset}`,
+    );
+  });
+
+  console.log('');
+
+  for (;;) {
+    const answer = await askQuestion(`Select repository (1-${projects.length}) [default: 1]: `);
+
+    if (!answer) {
+      return projects[0];
+    }
+
+    const idx = parseInt(answer, 10);
+
+    if (Number.isInteger(idx) && idx >= 1 && idx <= projects.length) {
+      return projects[idx - 1];
+    }
+
+    console.log(`${C.yellow}Invalid selection. Try again.${C.reset}`);
+  }
+};
+
+const selectState = async (preset) => {
+  const lower = (preset || '').toLowerCase();
+
+  if (STATES.includes(lower)) {
+    return lower;
+  }
+
+  console.log('');
+
+  STATES.forEach((s, i) => console.log(`  ${C.cyan}${i + 1}${C.reset}. ${s}`));
+
+  const answer = await askQuestion(`Select MR state (1-${STATES.length}) [default: 1=opened]: `);
+
+  if (!answer) {
+    return 'opened';
+  }
+
+  const idx = parseInt(answer, 10);
+
+  return Number.isInteger(idx) && idx >= 1 && idx <= STATES.length ? STATES[idx - 1] : 'opened';
+};
+
+const getMr = async (values = {}) => {
+  if (!gitlabConfig.url || !gitlabConfig.token) {
+    console.log(
+      `${C.yellow}GitLab configuration missing.${C.reset} Set GITLAB_URI and GITLAB_TOKEN in your env file.`,
+    );
+
+    process.exit(1);
+  }
+
+  const repoSpinner = createSpinner('Fetching repositories');
+
+  repoSpinner.start();
+
+  let projects;
+
+  try {
+    projects = await fetchProjects(values.search || '');
+
+    repoSpinner.stop(
+      `Loaded ${projects.length} repositor${projects.length === 1 ? 'y' : 'ies'}`,
+      projects.length > 0,
+    );
+  } catch (error) {
+    repoSpinner.stop('Failed to fetch repositories', false);
+    console.error(error.response?.data?.message || error.message);
+
+    return;
+  }
+
+  if (!projects.length) {
+    console.log('No repositories found.');
+
+    return;
+  }
+
+  const selected = await selectRepo(projects);
+  const state = await selectState(values.state);
+
+  const mrSpinner = createSpinner(`Fetching ${state} merge requests for ${selected.name}`);
+
+  mrSpinner.start();
+
+  let mrs;
+
+  try {
+    mrs = await fetchMergeRequests(selected.id, state);
+    mrSpinner.stop(
+      `Found ${mrs.length} merge request${mrs.length === 1 ? '' : 's'}`,
+      mrs.length > 0,
+    );
+  } catch (error) {
+    mrSpinner.stop('Failed to fetch merge requests', false);
+    console.error(error.response?.data?.message || error.message);
+
+    return;
+  }
+
+  if (!mrs.length) {
+    console.log(`${C.dim}No ${state} merge requests.${C.reset}`);
+
+    return;
+  }
+
+  console.log('');
+  console.log(
+    `${C.bold}${selected.name}${C.reset} ${C.dim}${selected.path_with_namespace}${C.reset}`,
+  );
+  console.log('');
+
+  const tree = buildTree(mrs);
+
+  tree.forEach((node) => printBranchNode(node));
+
+  console.log('');
+};
+
+module.exports = { getMr };

package/services/process-commands.js

@@ -2,13 +2,14 @@ const axios = require('axios');
 const { build, buildStatus } = require('./build');
 const { deploy } = require('./deploy');
 const { ACTIONS } = require('./enums/actions.enum');
-const { convertParamsToMap, wait, printTable, createSpinner } = require('./utils');
+const { convertParamsToMap, wait, printTable, createSpinner, makeLink } = require('./utils');
 const { createBranch } = require('./create-branch');
 const { mrAIReview } = require('./review');
 const { refactor } = require('./refactor');
 const { backup } = require('./mongodb-backup');
 const { merge } = require('./merge');
 const { cleanup } = require('./cleanup');
+const { getMr } = require('./mr-status');
 
 // Time entry imports
 const { getSprints } = require('./time-entry/utils');
@@ -23,6 +24,7 @@ const {
   getGitIdStats,
   getGitlabIssueMergeRequests,
   getGitMergeRequestDetails,
+  getTaskBrowserUrl,
 } = require('./task-stats');
 
 const processArgs = async (type, value) => {
@@ -333,8 +335,10 @@ Options:
 
               const mrDetails = await getGitlabIssueMergeRequests(gitIdDetails);
 
+              const taskUrl = getTaskBrowserUrl(task);
+
               return mrDetails.map((mrDetail) => ({
-                Task: task,
+                Task: taskUrl ? makeLink(taskUrl, task) : task,
                 Owner: taskDetail.owner,
                 ...mrDetail,
               }));
@@ -355,6 +359,25 @@ Options:
         break;
       }
 
+      case ACTIONS.MR_STATUS: {
+        if (value === '-help' || value === '--h') {
+          console.log(`usage: \tnu mr-status [-state <opened|merged|closed|all>] [-search <text>]
+\tnu mr-status [-st <state>] [-q <text>]
+
+List GitLab repositories you are a member of, select one, and view its merge requests in a branch tree view.
+
+Options:
+  -st, --state <state>     MR state filter | opened (default), merged, closed, all
+  -q,  --search <text>     Pre-filter repositories by name`);
+
+          break;
+        }
+
+        await getMr(values || {});
+
+        break;
+      }
+
       case ACTIONS.GET_TASK: {
         if (value === '-help' || value === '--h') {
           console.log(`usage: \tnu get-task [-task <task numbers with space>]
@@ -374,25 +397,47 @@ Options:
           process.exit(1);
         }
 
-        const tasks = {};
+        const taskNumbers = values.task.split(' ').filter(Boolean);
 
-        for (const task of values.task.split(' ')) {
-          const taskDetails = await getGitMergeRequestDetails(task);
+        const spinner = createSpinner('Fetching merge requests');
+        spinner.start();
 
-          if (taskDetails.error) {
-            console.log(`No merge requests found for task ${task}`);
+        try {
+          spinner.update(`Fetching ${taskNumbers.length} task(s)`);
 
-            continue;
-          }
+          const taskDetailsList = await Promise.all(
+            taskNumbers.map((task) =>
+              getGitMergeRequestDetails(task).then((details) => ({ task, details })),
+            ),
+          );
+
+          spinner.stop('Loaded merge request data', true);
+
+          const rows = [];
+
+          for (const { task, details: taskDetails } of taskDetailsList) {
+            if (taskDetails.error) {
+              rows.push({ GitLab: task, Zoho: 'No merge requests' });
+
+              continue;
+            }
 
-          for (const taskDetail of taskDetails) {
-            const zohoTaskMatch = taskDetail.description?.match(/itemdetails\/(I\d+)\)/);
+            let zoho = 'Not found';
 
-            tasks[task] = zohoTaskMatch ? zohoTaskMatch[1] : 'Not found';
+            for (const taskDetail of taskDetails) {
+              const zohoTaskMatch = taskDetail.description?.match(/itemdetails\/(I\d+)\)/);
+
+              zoho = zohoTaskMatch ? zohoTaskMatch[1] : 'Not found';
+            }
+
+            rows.push({ GitLab: task, Zoho: zoho });
           }
-        }
 
-        console.log(tasks);
+          printTable(rows, { columns: ['GitLab', 'Zoho'] });
+        } catch (error) {
+          spinner.stop('Failed to fetch merge requests', false);
+          throw error;
+        }
 
         break;
       }
@@ -517,7 +562,7 @@ Options:
         \t[${ACTIONS.BUILD}] [${ACTIONS.DEPLOY}] [${ACTIONS.BUILD_DEPLOY}]
         \t[${ACTIONS.CREATE_BRANCH}] [${ACTIONS.REVIEW}] [${ACTIONS.MERGE}]
         \t[${ACTIONS.CLEANUP}] [${ACTIONS.BACKUP}] [${ACTIONS.REFACTOR}]
-        \t[${ACTIONS.TASK_STATS}] [${ACTIONS.GET_TASK}]
+        \t[${ACTIONS.TASK_STATS}] [${ACTIONS.GET_TASK}] [${ACTIONS.MR_STATUS}]
         \t[${ACTIONS.TIME_INIT}] [${ACTIONS.TIME_ADD}] [${ACTIONS.TIME_STATUS}]\n
 Available commands:\n
   backup        : Backup MongoDB databases
@@ -527,6 +572,7 @@ Available commands:\n
   completion    : Setup shell autocomplete
   create-branch : Create git branch
   deploy        : Deploy specified components
+  mr-status        : List GitLab repos you contribute to and view merge requests as a tree
   get-task      : Get task details from GitLab merge requests
   merge         : Merge source branch into target branch
   refactor      : Refactor the provided text for improved clarity, conciseness, and professional quality
@@ -555,6 +601,8 @@ Example usage:\n
   nitor cleanup
   nitor create-branch -task <task number> -type <feat|fix> -description <description> -project <project short name>
   nitor deploy -project <project> -components <components> -instance <instance>
+  nitor mr-status
+  nitor mr-status -state opened
   nitor get-task -task <task numbers with space>
   nitor merge -source <source branch> -target <target branch>
   nitor refactor <text>

package/services/task-stats.js

@@ -1,5 +1,5 @@
 const axios = require('axios');
-const { zohoConfig, gitlabConfig } = require('./utils');
+const { zohoConfig, gitlabConfig, makeLink } = require('./utils');
 
 const getZohoUrl = (type, taskNumber) => {
   switch (type) {
@@ -11,6 +11,20 @@ const getZohoUrl = (type, taskNumber) => {
   }
 };
 
+// Browser URL for a Zoho Sprints task, e.g.
+// https://externalusers.zohosprints.com/workspace/4medica/client/wmoku#P29/itemdetails/I8856
+// Requires ZOHO_WORKSPACE (e.g. "4medica") and ZOHO_PROJECT_PREFIX (e.g. "P29")
+// to be set in the env file; returns an empty string if either is missing.
+const getTaskBrowserUrl = (taskNumber) => {
+  const { url, workspace, projectPrefix } = zohoConfig;
+
+  if (!url || !workspace || !projectPrefix || !taskNumber) {
+    return '';
+  }
+
+  return `${url}/workspace/${workspace}/client/wmoku#${projectPrefix}/itemdetails/I${taskNumber}`;
+};
+
 const getZohoConfig = (type, taskNumber) => {
   return {
     method: 'get',
@@ -153,10 +167,14 @@ const getGitlabIssueMergeRequests = async (gitDetails) => {
               const approvalResponse = await axios.request(approvalConfig);
               const approvalData = approvalResponse.data;
 
+              // Build browser URLs for IDs so they render as clickable links.
+              const issueUrl = gitDetail.web_url;
+              const mrUrl = mrData.web_url;
+
               // Merge approval data with MR data
               return {
-                GitID: gitDetail.iid,
-                MRID: mrData.iid,
+                GitID: issueUrl ? makeLink(issueUrl, gitDetail.iid) : gitDetail.iid,
+                MRID: mrUrl ? makeLink(mrUrl, mrData.iid) : mrData.iid,
                 MRStatus: mrData.state,
                 MRAssignedTo: mrData.assignee?.name,
                 MRTarget: mrData.target_branch,
@@ -202,4 +220,5 @@ module.exports = {
   getGitlabIssueDetails,
   getGitlabIssueMergeRequests,
   getGitMergeRequestDetails,
+  getTaskBrowserUrl,
 };

package/services/utils.js

@@ -31,6 +31,8 @@ const zohoConfig = {
   token: process.env.ZOHO_TOKEN,
   url: process.env.ZOHO_URI,
   userId: process.env.ZOHO_USERID,
+  workspace: process.env.ZOHO_WORKSPACE,
+  projectPrefix: process.env.ZOHO_PROJECT_PREFIX,
 };
 const keyMap = {
   components: 'components',
@@ -61,6 +63,10 @@ const keyMap = {
   do: 'docker',
   sprint: 'sprint',
   s: 'sprint',
+  state: 'state',
+  st: 'state',
+  search: 'search',
+  q: 'search',
 };
 const projectMap = {
   portal: 'medica-portal',
@@ -388,6 +394,23 @@ const box = {
 // Loading spinner frames
 const spinnerFrames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
 
+// Match CSI (SGR etc.) and OSC 8 hyperlink escape sequences so we can compute
+// the visible width of strings that contain ANSI styling or terminal links.
+// eslint-disable-next-line no-control-regex
+const ANSI_REGEX = /\x1B\]8;[^\x07\x1B]*(?:\x07|\x1B\\)|\x1B\[[0-9;]*[A-Za-z]/g;
+const stripAnsi = (s) => String(s ?? '').replace(ANSI_REGEX, '');
+const visibleLength = (s) => stripAnsi(s).length;
+
+/**
+ * Wrap text in an OSC 8 terminal hyperlink so supporting terminals render it
+ * as a clickable link.
+ */
+const makeLink = (url, text = url) => {
+  if (!url) return String(text ?? '');
+
+  return `\x1B]8;;${url}\x07${text}\x1B]8;;\x07`;
+};
+
 /**
  * Create a loading spinner for async operations
  * @param {string} message - Loading message to display
@@ -491,24 +514,27 @@ const printTable = (data, options = {}) => {
     });
   }
 
-  // Calculate column widths
+  // Calculate column widths (ignore ANSI/hyperlink escapes when measuring)
   const colWidths = {};
   columns.forEach((col) => {
     const headerLen = col.length;
-    const maxDataLen = Math.max(
-      ...filteredData.map((row) => String(row[col] ?? '').length),
-      headerLen,
-    );
+    const maxDataLen = Math.max(...filteredData.map((row) => visibleLength(row[col])), headerLen);
     colWidths[col] = Math.min(maxDataLen, maxColWidth);
   });
 
-  // Helper to truncate and pad text
+  // Helper to truncate and pad text while preserving ANSI/hyperlink escapes
   const formatCell = (text, width) => {
     const str = String(text ?? '');
-    if (str.length > width) {
-      return str.substring(0, width - 2) + '..';
+    const visible = visibleLength(str);
+
+    if (visible > width) {
+      // Only values without embedded escapes are safely truncatable; for
+      // links/colored values, fall back to stripped text to keep widths sane.
+      const plain = stripAnsi(str);
+      return plain.substring(0, width - 2) + '..';
     }
-    return str.padEnd(width);
+
+    return str + ' '.repeat(width - visible);
   };
 
   // Top border
@@ -560,8 +586,11 @@ const printTable = (data, options = {}) => {
       } else if (col === 'MRStatus') {
         cellColor =
           value === 'merged' ? colors.green : value === 'opened' ? colors.yellow : colors.dim;
-      } else if (col === 'Task' || col === 'MRID' || col === 'GitID') {
+      } else if (col === 'Task' || col === 'MRID' || col === 'GitID' || col === 'GitLab') {
         cellColor = colors.cyan;
+      } else if (col === 'Zoho') {
+        cellColor =
+          value === 'Not found' || value === 'No merge requests' ? colors.dim : colors.green;
       } else if (col === 'Owner' || col === 'MRAssignedTo') {
         cellColor = colors.magenta;
       } else if (col === 'Repo') {
@@ -620,4 +649,5 @@ module.exports = {
   gitlabConfig,
   printTable,
   createSpinner,
+  makeLink,
 };