SoftForge

AI AgenticX Indexer guide

Troubleshooting

agx is not found

Run AgenticX Indexer: Set Up Claude Code again, then open a new terminal or a new Claude Code session. In a shell started outside VS Code, check that the folder ~/.local/bin is on your path.

Claude Code does not use the map

Start a new session after the setup: a running session keeps the skills it started with. Then run /agx-index once in the project.

Results look old

Run agx index. This is needed only after a large change made outside the editor.

A file is missing from the results

  • Very large files and files that are not text are left out.
  • On Free, a codebase of more than 1,000 files keeps the files you use most. agx license status says how many are waiting.
  • Folders such as build output and installed packages are left out. agx config shows the list.

The status bar reads Sign in, or the command says it needs a plan

Your first hour is over and no plan is on. Click the status bar item and choose Sign in; on the page that opens, take the Free plan (it costs nothing) or Pro. On a computer without the editor, take the plan in the client portal and run agx license activate <key>.

The plan is not seen by the command

Open VS Code once while signed in: the command learns the plan from the editor. On a computer without the editor, use agx license activate <key>. agx license status says what the command sees and why.

A tool disappeared from Claude Code

AI AgenticX Indexer takes tools your sessions never use out of the way, only while no session is running. agx prune restore brings them all back; agx config set prune.enabled false turns this off.

Contact

Tell us what happened.