napi - Better Software Architecture for the AI Age

What is napi?

napi is a fully offline CLI that analyzes your codebase's architecture—dependencies, complexity, and structure—then lets you visualize and refactor it, all without sending your code anywhere. It generates dependency manifests from source code, stores them locally, and serves an interactive graph visualizer directly from the CLI.

How to use napi?

Install on Unix via curl -fsSL https://raw.githubusercontent.com/nanoapi-io/napi/refs/heads/main/install_scripts/install.sh | bash or download a binary from GitHub Releases. Use napi init to create a configuration, napi generate to produce a dependency manifest, and napi view to open an interactive visualizer in your browser.

Key features of napi

• Dependency analysis mapping every file, symbol, and dependency automatically.
• Audit detection for files exceeding complexity, size, or coupling thresholds.
• Interactive visualizer using Cytoscape.js graphs served locally in your browser.
• Symbol extraction of functions, classes, or symbols into standalone files.
• Optional AI labeling with OpenAI, Google, or Anthropic models.
• Fully offline operation with no accounts, servers, or data leaving your machine.

Use cases of napi

• Understand and visualize your codebase’s architecture to plan refactoring.
• Track dependency changes over time by generating manifests on every push.
• Extract complex symbols into separate files to reduce coupling.
• Enforce architecture quality gates in CI/CD pipelines.

FAQ from napi

Does napi send my code anywhere?

No. napi is fully offline—it never sends your code to any server. All processing happens locally on your machine.

Which programming languages does napi support?

Python, C#, C, and Java are currently supported. Support for C++, PHP, and JavaScript/TypeScript is in progress.

Where are dependency manifests stored?

Manifests are saved as JSON files in .napi/manifests/ relative to your project root. Each manifest contains branch, commit SHA, and timestamp metadata.

Can napi be used in CI/CD?

Yes. napi can generate manifests non-interactively using --branch, --commit-sha, and --commit-sha-date options. The README includes a GitHub Actions workflow example.

How do I enable AI labeling for dependencies?

Run napi set apiKey and follow the prompts to configure an API key for Google, OpenAI, or Anthropic. Labeling settings are stored globally in your OS config directory.