explaingit

shashanknidhi/aznex

Analysis updated 2026-05-18

1TypeScriptAudience · developerComplexity · 4/5LicenseSetup · moderate

TLDR

Aznex lets a team share the durable knowledge their AI coding agents pick up on a codebase, storing it centrally and serving it to any MCP-compatible agent.

Mindmap

mindmap
  root((Aznex))
    What it does
      Captures agent memory
      Stores centrally
      Serves via MCP
      Flags stale memory
    Tech stack
      TypeScript
      Bun
      Hono
      SQLite
    Use cases
      Team knowledge share
      Cross agent context
      Memory browsing
    Audience
      Developers
      Dev teams

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Share build quirks and architectural decisions your AI coding agent learns with the rest of your team.

USE CASE 2

Give any MCP-compatible coding agent access to knowledge captured by a teammate's agent session.

USE CASE 3

Flag stored knowledge as stale automatically when the code it describes changes.

USE CASE 4

Browse and search a team's accumulated coding-agent knowledge in a read-only web viewer.

What is it built with?

TypeScriptBunHonoSQLiteReact

How does it compare?

shashanknidhi/aznex0xkinno/neuralvault0xmayurrr/ai-contractauditor
Stars111
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatehardeasy
Complexity4/54/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Individual setup is one install script, team-wide setup requires an admin to deploy a service and register GitHub apps.

Apache 2.0: use, modify, and distribute freely, including commercially, as long as you keep the license notice.

In plain English

Aznex is a tool that lets a team of developers share the knowledge their AI coding assistants build up while working on a shared codebase. Tools like Claude Code or similar coding agents pick up useful context as they work, such as odd build quirks, why a certain design decision was made, or dead ends already tried, but normally that knowledge stays trapped on one person's computer and tied to one specific tool. Aznex instead stores it centrally, scoped to a single repository, and makes it available to any coding agent that speaks a shared connection standard called MCP. The system works through small hook adapters installed on each developer's machine that watch coding-agent sessions and send durable pieces of knowledge to a background worker. That worker cleans out anything that looks like a password or secret, twice, before sending it to a central service. The central service is the only part that touches the database, and it is also responsible for checking that a user actually has permission to access a given repository through the connected code host. It also flags older stored knowledge as possibly outdated if the code it refers to has since changed. The project is split into four pieces: shared type definitions, the local background worker that captures and scrubs data, the central service that stores data and answers agent queries, and a read-only web app for browsing and searching what the team has learned. It is built with TypeScript running on Bun, uses a small web framework called Hono for the service, SQLite moving toward Postgres for storage, and reuses a developer's own Claude Code login rather than requiring a separate API key. Getting started for an individual developer is a single install command supplied by a team administrator, which signs the developer in through GitHub and quietly sets up the background worker and hooks. Setting the system up for a whole team requires an administrator to deploy the central service, register a GitHub App and OAuth app, and choose which repositories are onboarded. The project is still in early development and is licensed under Apache 2.0.

Copy-paste prompts

Prompt 1
Help me install the Aznex worker and connect it to my Claude Code sessions.
Prompt 2
Explain how Aznex scrubs secrets before sending captured knowledge to the server.
Prompt 3
Walk me through deploying the Aznex service for my team as an admin.
Prompt 4
Show me how a memory gets flagged stale when its anchored code changes.

Frequently asked questions

What is aznex?

Aznex lets a team share the durable knowledge their AI coding agents pick up on a codebase, storing it centrally and serving it to any MCP-compatible agent.

What language is aznex written in?

Mainly TypeScript. The stack also includes TypeScript, Bun, Hono.

What license does aznex use?

Apache 2.0: use, modify, and distribute freely, including commercially, as long as you keep the license notice.

How hard is aznex to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is aznex for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.