1. Conduid
  2. Developer Tools
  3. Backtrack
MCP server · Developer Tools

Backtrack

by · github.com/SahilSaxena007/backtrack

MCP server: Backtrack

Unclaimed last commit 8 months ago devtools
InstallView source
47Fair

Scored 5 months ago · breakdown

About Backtrack

Backtrack is an MCP server published by SahilSaxena007 in the Developer Tools category: mCP server: Backtrack.

The repository has 1 stars and 0 forks, with the last commit 8 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.

Install

From source
git clone https://github.com/SahilSaxena007/backtrack

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Ask AI

✦

Ask AI about Backtrack

Powered by Claude · Grounded in docs

I know everything about Backtrack. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

Static checks derived from the repository 7 days ago. Heuristics on the source, not an audit.

  • ✓README presentThe repository ships documentation.
  • !License declaredNo license file. Legally you have no right to use it in a product.
  • !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
  • ✓Dependencies pinnedA lockfile pins dependency versions.
  • ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

README

Backtrack AI

Backtrack AI is an Electron desktop agent for safe file organization with natural language. It is built around a strict safety loop:

  1. Understand intent with Gemini.
  2. Generate a structured plan.
  3. Show a before/after preview.
  4. Execute only after explicit approval.
  5. Support deterministic undo.

Quality checks:

  • npm run lint (tsc --noEmit)
  • npm run build:main (main-process TypeScript compile)

Features

  • Floating agent button + detachable chat drawer.
  • Dedicated preview workspace (before/after + execution controls).
  • Human-in-the-loop approval before filesystem mutations.
  • Undo support for completed executions.
  • Folder scope onboarding and path validation.
  • MCP filesystem integration with local fallback support.

Tech Stack

  • Languages: TypeScript, JavaScript, HTML, CSS
  • Desktop: Electron
  • Frontend: React, Vite, Tailwind CSS, Zustand, Framer Motion
  • AI: Google Gemini via @google/generative-ai
  • Agent/tool layer: Model Context Protocol (@modelcontextprotocol/sdk)
  • File services: fs-extra

Repository Structure

  • src/main/: Electron main process, IPC handlers, execution/safety services
  • src/renderer/: React UI pages/components/stores
  • src/shared/: shared types for main/renderer contracts
  • dist/: build output

Prerequisites

  • Node.js 18+ (recommended: Node 20 LTS)
  • npm 9+
  • Windows is the current primary tested environment

Setup

  1. Install dependencies:
npm install
  1. Create environment file:
copy .env.example .env
  1. Set required env values in .env:
  • GEMINI_API_KEY (required)
  • GEMINI_MODEL (optional, default currently used by app: gemini-3-pro-preview)
  • BASE_PATH (optional)
  • MCP_ALLOWED_PATHS (optional)
  • USE_LOCAL_FS=1 (optional fallback mode if MCP filesystem server is unavailable)

Run

npm run dev

What to expect:

  1. Control panel opens.
  2. Click Deploy Agent Button.
  3. Open chat from the floating button.
  4. Enter a request, review preview, then approve execution if correct.

Example prompt:

Organize this folder by creating Images and Pdf folders, move image files to Images and pdf files to Pdf.

Commands

  • npm run dev: start Vite + Electron
  • npm run lint: TypeScript type-check
  • npm run build:main: compile Electron main process
  • npm run build: full production build
  • npm run verify: run lint + main build

Keyboard Shortcuts

  • Ctrl/Cmd + K: open chat drawer
  • Ctrl/Cmd + P: open preview workspace
  • Ctrl/Cmd + Z: undo latest organization

Troubleshooting

  • No files found in this folder yet:
    • Make sure the selected folder actually contains files.
    • Re-check onboarding folder selection and active scope.
  • Gemini key errors:
    • Ensure .env exists and GEMINI_API_KEY is valid.
  • MCP filesystem issues:
    • Use local fallback by setting USE_LOCAL_FS=1 in .env.
  • Port conflict on 8000:
    • Stop the process using the port, then re-run npm run dev.

Security model

  • Renderer runs with contextIsolation: true and sandbox: true.
  • Filesystem operations are executed through controlled main-process handlers.
  • Scope-boundary checks prevent planning/execution outside selected folder.

README fetched from the repository 7 days ago. The original is authoritative.

Questions

About Backtrack

How do I install Backtrack?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is Backtrack safe to use with an AI agent?

Its trust score is 47 out of 100 (fair). It passes 3 of the 6 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Backtrack still maintained?

The last commit was 8 months ago. That's long enough that you should check whether the maintainer is responding to issues before depending on it.