# Githena — AI-Powered GitHub Command Center

> Githena is an AI-powered GitHub repository command center and workspace management engine for software developers, tech leads, and open-source maintainers who manage many repositories.

## Project Summary

Githena simplifies multi-repository GitHub management by providing live OAuth synchronization, a bulk operations engine, AI codebase chat via Google Gemini, repository health auditing, and custom smart folder organization.

## Key Capabilities

- **GitHub OAuth Sync**: Instant OAuth sign-in and real-time synchronization with live GitHub user repositories.
- **Bulk Operations Engine**: Perform batch actions across multiple repositories simultaneously:
  - Batch edit project status and priority (P1–P4)
  - Bulk create repositories with customized names and language defaults
  - Toggle visibility between Public and Private
  - Batch assign topics, licenses, custom tags, and smart folders
  - Bulk delete or archive deprecated repositories
- **AI Codebase Chat**: Converse with repository context using Google Gemini for refactoring guidance, documentation, and code analysis.
- **Repository Health Audits**: Automatic 0–100 health scoring based on README presence, open issues, PR counts, licenses, and CI workflows.
- **Smart Folders & Multi-Tag Taxonomy**: Group repositories dynamically by priority, language, status, or custom user tags.
- **Project & Milestone Planner**: Map repositories directly to release milestones, deliverables, and architecture blueprints.

## Core API Interfaces

- `GET /api/auth/github/url` — Initiates GitHub OAuth authorization flow
- `POST /api/auth/github/sync` — Synchronizes live user repositories from GitHub
- `POST /api/ai/codebase-chat` — Answers questions about a repository using Gemini AI
- `POST /api/ai/generate-readme` — Auto-generates or improves markdown documentation for a codebase
- `POST /api/ai/generate-community-files` — Generates LICENSE, CONTRIBUTING, and CODE_OF_CONDUCT files
- `POST /api/ai/explain-repo` — Produces a structured technical report for a repository
- `POST /api/ai/architecture-diagram` — Generates a Mermaid.js architecture diagram
- `POST /api/ai/summarize-activity` — Summarizes commits into release notes or stand-up status
- `POST /api/webhooks/github` — Ingests GitHub webhook events (push, pull_request, issues, star)

## Links & Documentation

- Website: https://githena.netlify.app/
- Full Specifications: https://githena.netlify.app/llms-full.txt
- GitHub Repository: https://github.com/Githena-dev/Githena