Skip to main content
1

Install the CLI

Run the install script — it downloads the binary for your platform and places it in ~/.local/bin:
curl -fsSL https://raw.githubusercontent.com/fabiovedovelli/dev-visibility-application/main/scripts/install-devvis.sh | sh
To install to a different directory, set DEVVIS_INSTALL_DIR before running:
DEVVIS_INSTALL_DIR=/usr/local/bin \
  curl -fsSL https://raw.githubusercontent.com/fabiovedovelli/dev-visibility-application/main/scripts/install-devvis.sh | sh
Verify the install:
devvis version
# devvis (go) v0.1.0
2

Install Claude Code hooks (once per machine)

Register the DevVis hooks in your global Claude Code settings:
devvis setup-hooks
This merges five hooks into ~/.claude/settings.json — covering session start, session end, plan approval, and task lifecycle. A backup is created at ~/.claude/settings.devvis-backup.json before any changes are made.
This step is machine-level. You only need to run it once, even across multiple projects.
3

Initialize each project you want to track

In each repository root, run:
cd ~/work/my-project
devvis init <your-customer-key>
This creates .devvis/config.json with your customer key and appends .devvis/ to .gitignore automatically.
The customer key is stored at the project level to prevent it from leaking across different projects on the same machine. Never commit .devvis/config.json — the .gitignore entry added by init protects you by default.
That’s it. Claude Code will now capture sessions, tasks, and plans for that project and send them to the DevVis knowledge graph automatically.

​
Stopping tracking

To stop tracking a specific project (removes .devvis/ from that directory): 
devvis remove
To fully uninstall DevVis from the machine (removes hooks and the binary): 
devvis uninstall

​
Connect your Claude client

To query your knowledge graph from Claude, add the MCP Reader to your client config. 
{
  "mcpServers": {
    "devvisibility-reader": {
      "type": "http",
      "url": "https://devvis.com.br/mcp-reader/mcp?customer_key=<customer_key>"
    }
  }
}
Restart your Claude client after editing the config.