Skip to content

Unique-Divine/jiyuu / ai-skills/mori-graph

mori-graph

Verified

Code graph for cross-repo context. Use Mori, a local code graph and code memory served as MCP server mori-graph (Tree-sitter parsing, LSP-style call resolution), for structural and cross-repo questions; install it from Mori releases with mise, index repos, and link GraphQL clients to gqlgen resolvers across repos. Triggers on who calls this, what does X call, trace a call chain, impact analysis, which client uses this API field or resolver, unused or deprecated API fields, cross-repo links, dead code, graph query syntax, Cypher examples, index a repo, .cbmignore, reindex, cross-repo intelligence, installing or upgrading Mori, and working on the Mori source in jiyuu/mori.

FileKindSize
SKILL.mdskill md4.5 KB
references/graphql.mdmarkdown3.5 KB
references/setup.mdmarkdown3.8 KB
references/tool-source.mdmarkdown2.2 KB

references/setup.md

View on GitHub
# Setup: Install, Register, and Index

## Install From a Release

Mori ships as `mori/v*` releases of https://github.com/Unique-Divine/jiyuu,
with archives for `linux-x64`, `linux-arm64`, and `darwin-arm64`, a
`checksums.txt`, and build provenance attestations. Install with mise's
`github:` backend, which picks the archive for the platform:

```toml
# ~/.config/mise/config.toml
[tools]
"github:Unique-Divine/jiyuu" = { version = "0.13.0", version_prefix = "mori/v" }
```

```sh
mise lock --platform linux-arm64,linux-x64,macos-arm64   # with lockfile = true
mise install
codebase-memory-mcp --version   # codebase-memory-mcp 0.13.0
```

The archive holds one binary, `codebase-memory-mcp`, which mise exposes
through its shim. To upgrade, bump `version`, relock, install, then restart
the background daemon, which keeps the old binary until it restarts:

```sh
codebase-memory-mcp daemon stop
```

Remove any hand-built `codebase-memory-mcp` earlier on `PATH` (for example in
`~/.local/bin`), or it keeps shadowing the release.

## Register the MCP Server

Register the server once per client under the key `mori-graph`, with the
binary path and no arguments. Use a path that survives upgrades, such as
the mise shim (`~/.local/share/mise/shims/codebase-memory-mcp`) or a link to
it:

```sh
claude mcp add --scope user mori-graph -- ~/.local/share/mise/shims/codebase-memory-mcp
codex mcp add mori-graph -- ~/.local/share/mise/shims/codebase-memory-mcp
```

The key, not the binary, names the tools (`mcp__mori-graph__search_graph`),
so rename it in hook matchers, permission rules, and agent profiles that
list tools. Claude Code hooks that run `codebase-memory-mcp hook-augment`
keep working through the same binary path.

Don't run `codebase-memory-mcp install` or `update`: they rewrite this
skill, register the server as `codebase-memory-mcp`, and fetch a build
without Mori's GraphQL linking.

## Build From Source

For development, build from `mori/` in a Jiyuu checkout; see
[tool-source.md](tool-source.md). Run the dev binary from `build/c/` with a
separate cache rather than installing it over the release.

## Index a Repo

```sh
codebase-memory-mcp cli --quiet index_repository --repo_path ~/some-repo
```

- **Exclude data and build output** with a `.cbmignore` (gitignore syntax) at
  the repo root. JSON keys alone can outnumber code nodes ten to one. In repos
  you don't own, keep the file out of git with
  `echo /.cbmignore >> "$(git rev-parse --git-path info/exclude)"`.
- **Map extra extensions** in `~/.config/codebase-memory-mcp/config.json`, for
  example `{"extra_extensions": {".graphqls": "graphql"}}` on builds that
  don't map it already.
- **Retry a busy repo.** `aborted_previous_preserved` means files changed
  while indexing; the old index keeps serving. Run it again.
- **Never test with "gql" in a repo's path.** GraphQL calls are recognized by
  library names inside qualified names, and a path segment `gql` makes every
  call in the repo look like a GraphQL call.

## Link Repos

Cross-repo links are a separate pass, run per source project:

```sh
codebase-memory-mcp cli --quiet index_repository \
  '{"repo_path":"/path/to/client-repo","mode":"cross-repo-intelligence","target_projects":["server-project"]}'
```

- **Reindex, then relink.** A full reindex drops the project's cross-repo
  links. Rerun linking for it and for every project that links to it.
- **One run per project, every target in it.** A link run replaces that
  project's earlier links, so a client calling two servers lists both in
  `target_projects` in a single run.
- **Name the target** when two servers share field or route names, so a
  client links only to the server it calls. Use `["*"]` only when names are
  unique across projects.
- `index_status` shows `cross_repo.status` and the edge count for each
  project.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall