https://github.com/mcamner/repo-signal
AI-assisted repo analysis for turning rough prototypes into clear, documented, publishable GitHub projects.
https://github.com/mcamner/repo-signal
automation cli developer-tools documentation python repo-analysis
Last synced: about 1 month ago
JSON representation
AI-assisted repo analysis for turning rough prototypes into clear, documented, publishable GitHub projects.
- Host: GitHub
- URL: https://github.com/mcamner/repo-signal
- Owner: MCamner
- License: mit
- Created: 2026-05-02T15:21:32.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-05-21T02:58:03.000Z (about 1 month ago)
- Last Synced: 2026-05-21T08:29:01.635Z (about 1 month ago)
- Topics: automation, cli, developer-tools, documentation, python, repo-analysis
- Language: Python
- Homepage: https://mcamner.github.io/repo-signal/
- Size: 327 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Roadmap: docs/ROADMAP-0.2.0.md
Awesome Lists containing this project
README
# repo-signal
[](https://github.com/MCamner/repo-signal/actions/workflows/tests.yml)
[](https://github.com/MCamner/repo-signal/releases)
AI-native repository intelligence for structured reasoning systems.
`repo-signal` turns local repository state into clear analysis reports and
high-signal AI context exports. It helps you turn messy, undocumented
prototypes into clear, publishable GitHub projects.
---
## Install
```bash
git clone https://github.com/MCamner/repo-signal.git
cd repo-signal
python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[ai]"
```
---
## Try this in 60 seconds
```bash
# Get a high-level overview
repo-signal analyze
# Fast status report and next commit suggestion
repo-signal inspect
# Full readiness diagnosis
repo-signal doctor
# Check public-readiness signals
repo-signal publish-checklist .
```
---
## Command Surface
```text
repo-signal
├── analyze # Front-door orientation
├── inspect # Fast status and next commit
├── doctor # Full readiness diagnosis
├── publish-checklist # Public signal quality gate
├── repoaware # AI context export
└── demo # Generate example reports
```
See the [Command Surface](docs/COMMAND_SURFACE.md) and [Command Reference](docs/COMMANDS.md) for full details.
---
## Examples
- [Doctor Report (Markdown)](examples/doctor/doctor.txt)
- [Doctor Report (JSON)](examples/doctor/doctor.v1.json)
- [Analyze Report](examples/analyze/analyze.txt)
- [Inspect Report](examples/inspect/inspect.txt)
- [RepoAware Review](examples/repoaware/review.md)
Generate your own local demo reports:
```bash
repo-signal demo --generate
```
---
## Deep Documentation
- [**RepoAware**](docs/REPOAWARE.md) — High-signal AI context ranking and export
- [**Semantic Memory**](docs/SEMANTIC_MEMORY.md) — Uploading symbol maps to vector stores
- [**Publish Checklist**](docs/PUBLISH_CHECKLIST.md) — CI quality gates and portfolio checks
- [**Command Reference**](docs/COMMANDS.md) — Detailed CLI usage and flags
- [**Doctor Schema**](docs/DOCTOR_SCHEMA.md) — Machine-readable contract for `doctor --json`
- [**Repo Structure**](docs/README_STRUCTURE.md) — Best practices for project layout
---
## Planned features
Not started:
- safe patch suggestions
- positioning report
Partially implemented:
- GitHub Pages detection
- project type detection
- script/tool discovery
- wiki suggestion generator
- roadmap suggestion generator
---
## Author
Mattias Camner
Infrastructure / Platform Architect
Builder of command surfaces, endpoint readiness prototypes, and structured
workflow systems.
---
## License
MIT