ob-labs/agentseek

Add `agentseek doctor` diagnostics command

Closed

#87 opened on Jun 16, 2026

View on GitHubContributor guide
 (0 comments) (0 reactions) (0 assignees)Python (24 forks)github user discovery
comp:clienhancementhelp wanted

Repository metrics

Stars
 (153 stars)
PR merge metrics
 (Avg merge 3d 14h) (26 merged PRs in 30d)

Description

Summary

Add an agentseek doctor command that checks the local project environment and reports common setup problems before users run the project.

Requirements

  • Add a top-level agentseek doctor command.
  • Check whether the current directory has an AgentSeek-style project layout, including .env and pyproject.toml when applicable.
  • Check whether required local tools are available, at minimum uv; check docker when a compose file is present.
  • Report the detected run mode when it can be inferred.
  • Print human-readable pass/warn/fail results and exit non-zero when required checks fail.
  • Do not start services, install dependencies, or modify files.

Acceptance Criteria

  • Unit tests cover a healthy project, missing .env, missing uv, and compose project without Docker.
  • Diagnostics are deterministic and do not depend on actually launching the project.

Contributor guide

Research direction
Implement the `agentseek doctor` command and its unit tests as described in the issue.
Tech stack
python
Domain
cli
Issue type
Feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
Half day
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Fresh
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
Python
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
70