# superbigcup325/jumbit architecture

> Architecture diagram of the GitHub repository superbigcup325/jumbit, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/superbigcup325/jumbit
- Repository: https://github.com/superbigcup325/jumbit

## Overview

jumbit is a directory-history and frecency-based navigation tool, with shell hooks that record directory changes and keyword queries that return jump targets. Its documented agent-facing extensions add structured queries, persistent annotations, project-map export, and an MCP server; it also supports history migration, database inspection/editing, and nine shell integrations. The tree identifies the command, core, platform, and template layers, but sampled source does not show their call wiring, so edges are limited to documented responsibilities and flows.

Main entry points: [`cmd/main/run.mbt`](https://github.com/superbigcup325/jumbit/blob/main/cmd/main/run.mbt) (Command runtime), [`platform/store.mbt`](https://github.com/superbigcup325/jumbit/blob/main/platform/store.mbt) (Directory database), [`templates`](https://github.com/superbigcup325/jumbit/tree/main/templates) (Shell integration), [`cmd/main/run_status.mbt`](https://github.com/superbigcup325/jumbit/blob/main/cmd/main/run_status.mbt) (Status and edit)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["User interfaces"]
  node_cli["CLI parsing<br/>[cli.mbt]"]
  node_commands["Command runtime<br/>[run.mbt]"]
  node_shellgen["Shell integration"]
end

subgraph group_navigation["Directory memory"]
  node_query["Frecency query<br/>[database.mbt]"]
  node_record["Directory recording<br/>[run_add.mbt]"]
  node_annotations["Directory annotations<br/>[run_describe.mbt]"]
  node_historyimport["History migration<br/>[import.mbt]"]
end

subgraph group_data["Persistence"]
  node_store[("Directory database<br/>[store.mbt]")]
  node_configuration["Configuration<br/>[config.mbt]"]
  node_statusedit["Status and edit<br/>[run_status.mbt]"]
end

subgraph group_integrations["Extensions"]
  node_structured["JSON and TSV<br/>[json.mbt]"]
  node_agentexport["Project map export<br/>[run_export.mbt]"]
  node_mcp["MCP server<br/>[run_mcp.mbt]"]
end

node_user(("User"))
node_shell(("Shell"))
node_agent(("Coding agent"))
node_fzf["fzf selector"]
node_editor["Editor"]

node_user -->|"changes directory"| node_shell
node_shell -->|"loads integration"| node_shellgen
node_shellgen -->|"records via add"| node_commands
node_user -->|"runs command"| node_cli
node_agent -->|"runs command"| node_cli
node_cli -->|"dispatches"| node_commands
node_commands -->|"adds directory"| node_record
node_commands -->|"searches history"| node_query
node_query -->|"reads and ranks"| node_store
node_record -->|"updates history"| node_store
node_commands -->|"sets annotations"| node_annotations
node_annotations -->|"persists annotations"| node_store
node_commands -->|"imports history"| node_historyimport
node_historyimport -->|"merges entries"| node_store
node_commands -->|"checks or edits"| node_statusedit
node_statusedit -->|"reads or updates"| node_store
node_commands -->|"loads settings"| node_configuration
node_commands -->|"formats query output"| node_structured
node_commands -->|"exports project map"| node_agentexport
node_commands -->|"starts server"| node_mcp
node_mcp -->|"queries directories"| node_query
node_mcp -->|"exports map"| node_agentexport
node_shellgen -.->|"interactive selection"| node_fzf
node_statusedit -.->|"opens editor"| node_editor

click node_cli "https://github.com/superbigcup325/jumbit/blob/main/cli/cli.mbt"
click node_commands "https://github.com/superbigcup325/jumbit/blob/main/cmd/main/run.mbt"
click node_shellgen "https://github.com/superbigcup325/jumbit/tree/main/templates"
click node_query "https://github.com/superbigcup325/jumbit/blob/main/core/database.mbt"
click node_record "https://github.com/superbigcup325/jumbit/blob/main/cmd/main/run_add.mbt"
click node_annotations "https://github.com/superbigcup325/jumbit/blob/main/cmd/main/run_describe.mbt"
click node_historyimport "https://github.com/superbigcup325/jumbit/blob/main/core/import.mbt"
click node_store "https://github.com/superbigcup325/jumbit/blob/main/platform/store.mbt"
click node_configuration "https://github.com/superbigcup325/jumbit/blob/main/config/config.mbt"
click node_statusedit "https://github.com/superbigcup325/jumbit/blob/main/cmd/main/run_status.mbt"
click node_structured "https://github.com/superbigcup325/jumbit/blob/main/cmd/main/json.mbt"
click node_agentexport "https://github.com/superbigcup325/jumbit/blob/main/cmd/main/run_export.mbt"
click node_mcp "https://github.com/superbigcup325/jumbit/blob/main/cmd/main/run_mcp.mbt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_commands,node_shellgen,node_user toneBlue
class node_query,node_record,node_annotations,node_historyimport toneAmber
class node_store,node_configuration,node_statusedit toneMint
class node_structured,node_agentexport,node_mcp toneRose
class node_shell,node_agent,node_fzf,node_editor toneIndigo
```

## Components

### User interfaces

- [CLI parsing](https://github.com/superbigcup325/jumbit/blob/main/cli/cli.mbt): `cli/cli.mbt`
- [Command runtime](https://github.com/superbigcup325/jumbit/blob/main/cmd/main/run.mbt): `cmd/main/run.mbt`
- [Shell integration](https://github.com/superbigcup325/jumbit/tree/main/templates): `templates`

### Directory memory

- [Frecency query](https://github.com/superbigcup325/jumbit/blob/main/core/database.mbt): `core/database.mbt`
- [Directory recording](https://github.com/superbigcup325/jumbit/blob/main/cmd/main/run_add.mbt): `cmd/main/run_add.mbt`
- [Directory annotations](https://github.com/superbigcup325/jumbit/blob/main/cmd/main/run_describe.mbt): `cmd/main/run_describe.mbt`
- [History migration](https://github.com/superbigcup325/jumbit/blob/main/core/import.mbt): `core/import.mbt`

### Persistence

- [Directory database](https://github.com/superbigcup325/jumbit/blob/main/platform/store.mbt): `platform/store.mbt`
- [Configuration](https://github.com/superbigcup325/jumbit/blob/main/config/config.mbt): `config/config.mbt`
- [Status and edit](https://github.com/superbigcup325/jumbit/blob/main/cmd/main/run_status.mbt): `cmd/main/run_status.mbt`

### Extensions

- [JSON and TSV](https://github.com/superbigcup325/jumbit/blob/main/cmd/main/json.mbt): `cmd/main/json.mbt`
- [Project map export](https://github.com/superbigcup325/jumbit/blob/main/cmd/main/run_export.mbt): `cmd/main/run_export.mbt`
- [MCP server](https://github.com/superbigcup325/jumbit/blob/main/cmd/main/run_mcp.mbt): `cmd/main/run_mcp.mbt`

### Other components

- **User**
- **Shell**
- **Coding agent**
- **fzf selector**
- **Editor**

## Connections

- User → Shell: changes directory
- Shell → Shell integration: loads integration
- Shell integration → Command runtime: records via add
- User → CLI parsing: runs command
- Coding agent → CLI parsing: runs command
- CLI parsing → Command runtime: dispatches
- Command runtime → Directory recording: adds directory
- Command runtime → Frecency query: searches history
- Frecency query → Directory database: reads and ranks
- Directory recording → Directory database: updates history
- Command runtime → Directory annotations: sets annotations
- Directory annotations → Directory database: persists annotations
- Command runtime → History migration: imports history
- History migration → Directory database: merges entries
- Command runtime → Status and edit: checks or edits
- Status and edit → Directory database: reads or updates
- Command runtime → Configuration: loads settings
- Command runtime → JSON and TSV: formats query output
- Command runtime → Project map export: exports project map
- Command runtime → MCP server: starts server
- MCP server → Frecency query: queries directories
- MCP server → Project map export: exports map
- Shell integration → fzf selector: interactive selection
- Status and edit → Editor: opens editor