Tools

project_info

Comprehensive project metadata and structure detection

The project_info tool provides a complete overview of your project's configuration, structure, and technology stack. It automatically detects frameworks, package managers, languages, build tools, CI/CD configurations, and more.

How It Works

Stellarion scans your project root for configuration files (package.json, Cargo.toml, pyproject.toml, etc.) and analyzes file patterns to detect the technology stack. It aggregates this information into a comprehensive project profile.

When to Use

  • Understanding a new codebase: Get a quick overview of what you're working with
  • Checking project configuration: Verify detected frameworks and tools
  • Verifying framework detection: Ensure Stellarion understands your project correctly
  • Getting project statistics: File counts, language distribution, activity
  • Onboarding new team members: Provide project context quickly

Parameters

ParameterTypeRequiredDefaultDescription
pathstringNo.Project root to analyze
includeLanguagesbooleanNofalseInclude detailed language distribution
includeStatsbooleanNofalseInclude file size statistics
includeDocsbooleanNofalseScan documentation directory
includeActivitybooleanNofalseInclude recent file activity timestamps
includeReadmebooleanNofalseExtract README content and summary

MCP Command Syntax

mcp__stellarion__project_info includeLanguages:true includeStats:true includeActivity:true

Examples

Basic Project Info

Natural Language:

What kind of project is this? Give me the project overview.

Direct MCP Call:

mcp__stellarion__project_info

Returns: Project type, frameworks, package manager, dependencies


Full Overview with Statistics

Natural Language:

Give me a complete overview of this project including languages, file statistics, and recent activity

Direct MCP Call:

mcp__stellarion__project_info includeLanguages:true includeStats:true includeActivity:true

Returns: Comprehensive project profile with all available information


Check Language Distribution

Natural Language:

What languages are used in this project and how many files of each?

Direct MCP Call:

mcp__stellarion__project_info includeLanguages:true

Returns: File count by language/extension


Check Frameworks

Natural Language:

What frameworks does this project use?

Direct MCP Call:

mcp__stellarion__project_info

Returns: Detected frameworks based on dependencies and file patterns


Include Documentation Status

Natural Language:

Show me the project info including documentation overview

Direct MCP Call:

mcp__stellarion__project_info includeDocs:true includeReadme:true

Returns: Project info plus docs/ directory contents and README summary


Analyze Project Size

Natural Language:

How big is this project? Show me file statistics.

Direct MCP Call:

mcp__stellarion__project_info includeStats:true

Returns: Total files, sizes, largest files, storage usage

Output Format

Project Type Detection

Project TypeDetection Method
nodejspackage.json present
rustCargo.toml present
pythonpyproject.toml, setup.py, or requirements.txt
javapom.xml or build.gradle
gogo.mod present
phpcomposer.json present
rubyGemfile present

Framework Detection

CategoryExamples
FrontendReact, Vue, Angular, Svelte, Next.js, Nuxt
BackendExpress, FastAPI, Spring, Django, Flask, Rails
TestingJest, Mocha, Pytest, JUnit
BuildWebpack, Vite, Rollup, Parcel

Package Manager Detection

ManagerDetection
npmpackage-lock.json
yarnyarn.lock
pnpmpnpm-lock.yaml
cargoCargo.lock
piprequirements.txt
poetrypoetry.lock

Language Distribution

When includeLanguages: true:

TypeScript: 145 files (65%)
JavaScript: 45 files (20%)
Python: 25 files (11%)
JSON: 8 files (4%)

File Statistics

When includeStats: true:

MetricDescription
Total filesNumber of tracked files
Total sizeCombined file size
Average sizeMean file size
Largest fileBiggest file in project

Build Tools

Detected build and development tools:

ToolDetection
Webpackwebpack.config.js
Vitevite.config.ts
ESBuildesbuild configuration
MakeMakefile
Gradlebuild.gradle

CI/CD Detection

PlatformDetection
GitHub Actions.github/workflows/
GitLab CI.gitlab-ci.yml
CircleCI.circleci/config.yml
Travis.travis.yml
JenkinsJenkinsfile

Code Quality Tools

ToolDetection
ESLint.eslintrc.*
Prettier.prettierrc.*
ClippyRust clippy config
BlackPython black config
Husky.husky/ directory

License Detection

Detected license type:

  • MIT, Apache 2.0, GPL, BSD, ISC, Proprietary

Tips for Effective Use

  1. Use as starting point: Run project_info first when exploring a new codebase
  2. Verify detection: Check that frameworks are correctly identified before using other tools
  3. Include languages for large projects: Understand the tech stack distribution
  4. Check activity for maintenance: See how recently files were modified
  5. Combine with index_project: Get info first, then index for full analysis

Combining with Other Tools

# 1. Understand the project
mcp__stellarion__project_info includeLanguages:true

# 2. Index for semantic search
mcp__stellarion__index_project

# 3. Analyze quality
mcp__stellarion__analyze_quality type:complexity

# 4. Find improvements
mcp__stellarion__find_refactoring includePriority:true