core/go-ai

No description

Find a file

Snider 55e537a55c feat: migrate metrics command from CLI Move AI metrics tracking command from core/cli cmd/ai into go-ai where the metrics backend lives. Co-Authored-By: Virgil <virgil@lethean.io>		2026-02-21 20:42:17 +00:00
ai	test: Phase 5 — testing gaps (process/RAG/ML mocks, metrics bench)	2026-02-20 06:48:31 +00:00
cmd	feat: migrate metrics command from CLI	2026-02-21 20:42:17 +00:00
docs	docs: graduate TODO/FINDINGS into production documentation	2026-02-20 14:54:05 +00:00
mcp	fix(mcp): harden REST bridge with body limit, error classification, sanitised messages	2026-02-21 01:27:06 +00:00
.gitignore	chore: update module paths and add gitignore	2026-02-17 19:19:38 +00:00
CLAUDE.md	docs: graduate TODO/FINDINGS into production documentation	2026-02-20 14:54:05 +00:00
go.mod	feat(cmd/rag): re-export go-rag CLI commands through go-ai	2026-02-21 20:23:22 +00:00
go.sum	feat(cmd/rag): re-export go-rag CLI commands through go-ai	2026-02-21 20:23:22 +00:00
README.md	docs: add README with quick start and docs links	2026-02-20 15:11:19 +00:00
TEST-RESULTS.md	test: validate MLX inference and scoring pipeline on M3 Ultra	2026-02-16 17:24:36 +00:00

README.md

go-ai

MCP (Model Context Protocol) hub for the Lethean AI stack. Exposes 49 tools across file operations, directory management, language detection, RAG vector search, ML inference and scoring, process management, WebSocket streaming, browser automation via Chrome DevTools Protocol, JSONL metrics, and an IDE bridge to the Laravel core-agentic backend. The package is a pure library — the Core CLI (core mcp serve) imports it and handles transport selection (stdio, TCP, or Unix socket).

Module: forge.lthn.ai/core/go-ai Licence: EUPL-1.2 Language: Go 1.25

Quick Start

import "forge.lthn.ai/core/go-ai/mcp"

svc, err := mcp.New(
    mcp.WithWorkspaceRoot("/path/to/project"),
    mcp.WithProcessService(ps),
)
// Run as stdio server (default for AI client subprocess integration)
err = svc.Run(ctx)
// Or TCP: MCP_ADDR=127.0.0.1:9100 triggers ServeTCP automatically

Documentation

Architecture — MCP server, subsystem plugin model, tool inventory, IDE bridge, transports
Development Guide — building, testing, adding tools
Project History — completed phases and known limitations

Build & Test

go test ./...
go test -race ./...
go build ./...

Licence

European Union Public Licence 1.2 — see LICENCE for details.