chore: update README.md

Author: omarabid

README.md

@@ -1,7 +1,7 @@
-<h1 align="center">codeinput</h1>
+<h1 align="center">Code Input CLI</h1>
 <div align="center">
  <strong>
-   codeinput CLI
+   Advanced CODEOWNERS file management and analysis toolkit
  </strong>
 </div>
 <br/>
@@ -10,31 +10,250 @@
 [![Tests](https://github.com/CodeInputCorp/cli/actions/workflows/tests.yml/badge.svg)](https://github.com/CodeInputCorp/cli/actions/workflows/tests.yml)
 [![Build](https://github.com/CodeInputCorp/cli/actions/workflows/build.yml/badge.svg)](https://github.com/CodeInputCorp/cli/actions/workflows/build.yml)
 
-`codeinput` is a CLI for [codeinput](https://codeinput.com).
+`codeinput` is a powerful CLI tool for parsing, analyzing, and managing CODEOWNERS files across your repositories. It provides advanced querying capabilities, ownership analysis, and tag-based file organization.
 
 <!-- START doctoc generated TOC please keep comment here to allow auto update -->
 <!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
-**Table of Contents**
 
-- [About](#about)
-- [How to Contribute](#how-to-contribute)
-  - [Versioning](#versioning)
-- [License](#license)
 
 <!-- END doctoc generated TOC please keep comment here to allow auto update -->
 
-## About
+## Features
 
-`codeinput` is a CLI for [codeinput](https://codeinput.com).
+### CodeOwners
+- **Advanced Parsing**: Parse CODEOWNERS files recursively across directory structures
+- **Ownership Analysis**: Analyze file ownership patterns and generate detailed reports  
+- **Tag Support**: Organize and query files using custom tags in CODEOWNERS  
+- **High Performance**: Efficient caching and parallel processing for large repositories  
+- **Flexible Filtering**: Filter files by owners, tags, or ownership status  
+- **Multiple Output Formats**: Support for text, JSON, and binary output formats  
 
-## How to Contribute
+## Installation
+
+### From Release
+Binaries coming soon...
+
+### From Cargo
+
+You can install the CLI using Cargo. Rust Toolchain required.
+
+```bash
+cargo install ci
+```
+
+### From Source
+```bash
+git clone https://github.com/CodeInputCorp/cli.git
+cd cli
+cargo build --release --bin ci
+sudo cp target/release/ci /usr/local/bin/
+```
+
+## Quick Start
+
+1. **Parse your CODEOWNERS files** to build the cache:
+   ```bash
+   ci codeowners parse
+   ```
+
+2. **List all files with their owners**:
+   ```bash
+   ci codeowners list-files
+   ```
+
+3. **Find files owned by a specific team**:
+   ```bash
+   ci codeowners list-files --owners @frontend-team
+   ```
+
+4. **Inspect ownership of a specific file**:
+   ```bash
+   ci codeowners inspect src/main.rs
+   ```
+
+## Commands
+
+### CodeOwners
+
+#### Parse CODEOWNERS
+
+Build a cache of parsed CODEOWNERS files for fast querying:
+
+```bash
+ci codeowners parse [PATH] [OPTIONS]
+```
+
+**Options:**
+- `--cache-file <FILE>`: Custom cache file location (default: `.codeowners.cache`)
+- `--format <FORMAT>`: Cache format - `bincode` or `json` (default: `bincode`)
+
+**Examples:**
+```bash
+# Parse current directory
+ci codeowners parse
+
+# Parse specific directory with JSON cache
+ci codeowners parse ./my-repo --format json
+
+# Use custom cache location
+ci codeowners parse --cache-file .custom-cache
+```
+
+### List Files
+
+Find and list files with their owners based on filter criteria:
+
+```bash
+ci codeowners list-files [PATH] [OPTIONS]
+```
+
+**Options:**
+- `--tags <LIST>`: Filter by tags (comma-separated)
+- `--owners <LIST>`: Filter by owners (comma-separated)
+- `--unowned`: Show only unowned files
+- `--show-all`: Show all files including unowned/untagged
+- `--format <FORMAT>`: Output format - `text`, `json`, or `bincode`
+
+**Examples:**
+```bash
+# List all owned files
+ci codeowners list-files
+
+# Find files with specific tags
+ci codeowners list-files --tags security critical
+
+# Find files owned by multiple teams
+ci codeowners list-files --owners @backend-team @devops
+
+# Show unowned files
+ci codeowners list-files --unowned
+
+# Output as JSON
+ci codeowners list-files --format json
+```
+
+### List Owners
+
+Display aggregated owner statistics and file associations:
+
+```bash
+ci codeowners list-owners [PATH] [OPTIONS]
+```
 
-Details on how to contribute can be found in the [CONTRIBUTING.md](.github/CONTRIBUTING.md) file.
+**Options:**
+- `--format <FORMAT>`: Output format - `text`, `json`, or `bincode`
 
-### Versioning
+**Examples:**
+```bash
+# Show all owners with file counts
+ci codeowners list-owners
+
+# Get owner data as JSON
+ci codeowners list-owners --format json
+```
+
+### List Tags
+
+Analyze tag usage across CODEOWNERS files:
+
+```bash
+ci codeowners list-tags [PATH] [OPTIONS]
+```
+
+**Options:**
+- `--format <FORMAT>`: Output format - `text`, `json`, or `bincode`
+
+**Examples:**
+```bash
+# Show all tags with usage statistics
+ci codeowners list-tags
+
+# Export tag data as JSON
+ci codeowners list-tags --format json
+```
+
+### Inspect Files
+
+Get detailed ownership and tag information for a specific file:
+
+```bash
+ci codeowners inspect <FILE_PATH> [OPTIONS]
+```
+
+**Options:**
+- `--repo <PATH>`: Repository path (default: current directory)
+- `--format <FORMAT>`: Output format - `text`, `json`, or `bincode`
+
+**Examples:**
+```bash
+# Inspect a specific file
+ci codeowners inspect src/main.rs
+
+# Inspect with different repo path
+ci codeowners inspect src/main.rs --repo /path/to/repo
+
+# Get inspection data as JSON
+ci codeowners inspect src/main.rs --format json
+```
+
+### Configuration
+
+View current configuration settings:
+
+```bash
+ci config
+```
+
+### Shell Completion
+
+Generate shell completion scripts:
+
+```bash
+# For bash
+ci completion bash > /etc/bash_completion.d/codeinput
+
+# For zsh
+ci completion zsh > ~/.zsh/completions/_codeinput
+
+# For fish
+ci completion fish > ~/.config/fish/completions/codeinput.fish
+```
+
+## CODEOWNERS Format
+
+The tool supports standard CODEOWNERS syntax with additional tag support:
+
+```
+# Standard ownership
+*.rs @rust-team
+/docs/ @documentation-team
+
+# With tags for categorization
+*.security.rs @security-team #security #critical
+/api/ @backend-team #api #core
+
+# Multiple owners and tags
+*.config @devops @security-team #config #infrastructure #security
+
+# Special patterns
+* @default-team #general
+```
+
+**Supported Owner Types:**
+- **Users**: `@username`
+- **Teams**: `@org/team-name`
+- **Email**: `user@example.com`
+- **Unowned**: `NOOWNER` (case-insensitive)
+
+**Tag Format:**
+- Tags start with `#` and appear after owners
+- Multiple tags are supported: `#tag1 #tag2 #tag3`
+- Tags can contain letters, numbers, hyphens, and underscores
+
+## How to Contribute
 
-codeinput adheres to the [SemVer](https://semver.org/) Semantic Versioning.
+We welcome contributions! Please see our [Contributing Guide](.github/CONTRIBUTING.md) for details.
 
 ## License
 
-`codeinput` is licensed under the MIT license. Please read the [LICENSE](LICENSE) file in this repository for more information.
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.