Skip to content

Explain: custom agent paths #109

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
AIM289 merged 1 commit into from
Mar 31, 2026
Merged

Explain: custom agent paths #109

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 14 additions & 4 deletions explain/agents.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -42,13 +42,23 @@ def find_binary(cls) -> Path | None:
"""
Find and return the path to the agent binary.

Checks the EXPLAIN_{AGENT}_PATH environment variable first (e.g.
EXPLAIN_CLAUDE_PATH, EXPLAIN_AMP_PATH), before falling back to a PATH lookup.

Returns:
Path to the agent binary, or None if not found

Raises:
FileNotFoundError: If the EXPLAIN_{AGENT}_PATH environment variable is set but the path
could not be found
"""
if loc := shutil.which(cls.program_name):
return Path(loc)
else:
return None
env_var = f"EXPLAIN_{cls.name.upper()}_PATH"
program = os.environ.get(env_var) or cls.program_name
if loc := shutil.which(program):
return Path(loc).absolute()
if os.environ.get(env_var):
raise FileNotFoundError(f"{env_var} is set to {program!r} but it could not be found.")
return None

@abstractmethod
async def ask(self, question: str, port: int, tools: list[str]) -> str:
Expand Down
Loading