Skip to content

drew1two/AIMED

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

37 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

AIMED Scope Logo AIMED - AI Monitoring & Execution Dashboard

Keeping AI costs down by keeping LLM's 'AIMED' at the target!

Version v0.1.2

Visual Interface for the RAG used in each project


Roo Code Logo    CLine Logo    Windsurf Cascade Logo    Cursor IDE Logo


What is AIMED?

AIMED (AI Monitoring & Execution Dashboard) is a self-contained web interface built on a bundled, modified version of ConPort MCP that provides visual access to project context knowledge used by AI assistants.

The Difference: Read-Only vs. Read-Write Memory Other tools treat AI memory as a read-only cache. AIMED treats it as a read-write document that YOU control — a transparent “Project Brain” you can inspect and correct.

AIMED = ConPort MCP (modified & bundled) + Web Dashboard

Visual Tour

Dashboard Views

Activity Feed Dashboard

Activity Feed - Track recent decisions, progress, and context changes

Kanban Progress Dashboard

Kanban Board - Drag-and-drop task management

Knowledge Graph

Knowledge Graph Search

Interactive Knowledge Graph - Visualize project relationships

Edit Graph Relationships

Edit Relationships - Right-click to modify connections

Context & Documentation Management

Edit Contexts

Context Editor - Manage product and active contexts

View All Entries

Entry Management - View and edit all project entries

Documentation Section

Documentation Hub - Centralized documentation access

Generated Documentation

Auto-Generated Docs - View/edit project documentation files

Workspace Management

Workspace Info Initial

Workspace Info - Compact view

Workspace Info Expanded

Workspace Info - Expanded details

Progress Tracking

Progress Tracking - Monitor task completion and status

Key Benefits

  • How does your AI view your project? Provides insight into what the AI actually sees
  • Reduce AI token costs by eliminating context baggage and managing what your AI uses
  • Glass-box “Project Brain” — inspect and correct the context your assistant runs on
  • Visual knowledge graph showing relationships between decisions, progress, patterns and custom data
  • Multi-workspace isolation Ability to work on multiple workspaces at the same time with workspace isolation.

See AIMED-BENEFITS.md for complete features and capabilities.

⚠️ Important: Compatibility with ConPort MCP

AIMED uses a modified version of ConPort MCP that enables seamless web interface integration but results in incompatibility with the original ConPort MCP server.

If you're currently using ConPort MCP: Please temporarily disable/turn off your existing ConPort MCP server in your IDE before running AIMED to avoid conflicts.

Custom Instructions Required: Conport and AIMED requires IDE-specific custom instructions for optimal LLM integration. Use the appropriate strategy file from conport-custom-instructions/ directory:

Copy the entire content of the relevant strategy file into your LLM's custom instructions.

Feel free to use these as a base for your own custom instructions.

Getting Started

📋 Quick Start Guide (Copy-Paste Instructions)

QUICK_START.md - Condensed copy-paste instructions to get up and running fast

Perfect for experienced users who want minimal explanations and maximum action.

📖 Full Installation Guide (Detailed Explanations)

INSTALLATION_GUIDE.md - Complete setup instructions with troubleshooting

Includes detailed explanations, troubleshooting steps, advanced configuration options, and platform-specific guidance.


Quick Overview

New Project Workflow:

  1. Turn OFF conport-aimed MCP server in your IDE
  2. Create project folder + Python environment (venv/conda/etc.) and activate it
  3. Turn ON conport-aimed MCP server (creates context_portal_aimed/ automatically)
  4. Add context_portal_aimed/ to .gitignore
  5. Launch dashboard: python context_portal_aimed/portal_launcher.py

Existing Project:

  1. Ensure Python environment exists and is activated
  2. Turn on conport-aimed MCP server (creates context_portal_aimed/ if missing)
  3. Add context_portal_aimed/ to .gitignore
  4. Launch dashboard: python context_portal_aimed/portal_launcher.py

Architecture: AIMED uses a modified version of ConPort MCP (equivalent to v0.3.8). It creates context_portal_aimed/ directory for workspace isolation. Each project runs independent server instances with separate port allocation.

Features

Web Dashboard

  • Activity feed showing recent decisions, progress, and context changes
  • Kanban board for task management with drag-and-drop functionality
  • Interactive knowledge graph displaying project element relationships
  • Context editors for product and active project contexts
  • Search interface with full-text and semantic search capabilities
  • CRUD interfaces for decisions, progress items, system patterns, custom data

Backend (ConPort MCP)

  • SQLite database with automatic schema migrations
  • Model Context Protocol server for AI assistant integration
  • Multi-workspace isolation with per-project databases
  • Vector embeddings for semantic search
  • Full-text search with FTS5
  • Knowledge graph with explicit relationship tracking

Technical Details

  • Frontend: Next.js 14 with TypeScript, TailwindCSS, TanStack Query
  • Backend: FastAPI server with FastMCP integration
  • Database: SQLite with Alembic migrations
  • Search: FTS5 full-text search + vector embeddings
  • Architecture: Multi-workspace isolation with port-based routing

Attribution

AIMED extends ConPort MCP by GreatScottyMac.

  • ConPort MCP: Copyright © 2025 GreatScottyMac and contributors, licensed under Apache License 2.0
  • AIMED Visual Extensions: Copyright © 2025 AIMED Contributors
  • Current ConPort equivalent: v0.3.8

See NOTICE for complete attribution details.

Documentation

Community & Support

About

No description, website, or topics provided.

Resources

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors