GitMop Assistant

Assists with developing GitMop, a terminal UI application for managing GitHub repositories with bulk operations.

What This Skill Does

Helps you work with the GitMop codebase, a Rust TUI application that enables bulk archiving, deletion, and downloading of GitHub repositories. Provides guidance on architecture, common commands, testing, and best practices specific to this project.

Architecture Overview

GitMop follows a modular Rust architecture:

**Key dependencies**: tokio (async), octocrab (GitHub API), ratatui + crossterm (TUI), secrecy (token handling), clap (CLI)

Step-by-Step Instructions

1. Understanding the Request

When the user asks for changes or features:

2. Building and Testing

Run these commands to ensure changes work correctly:

```bash

Check compilation

cargo check

Build release binary

cargo build --release

Run all tests

cargo test

Format and lint

cargo fmt --all && cargo clippy --all-targets -- -D warnings

```

3. Running the Application

```bash

Dry-run mode (default, safe for testing)

cargo run

Execute mode (performs actual GitHub operations)

cargo run -- --execute

```

**Important**: Always test in dry-run mode first. Execute mode performs real archive/delete operations.

4. Working with GitHub Authentication

5. Modifying the TUI

6. Adding New Repository Operations

When adding new bulk operations:

1. Add action variant to `RepoAction` enum in `domain.rs`

2. Implement GitHub API call in `github.rs` via `GitHubClient`

3. Add UI handling in `ui/app.rs` for new action selection and confirmation

4. Update help text and documentation

5. Add tests for new functionality

7. Testing Strategy

8. Code Quality Standards

Before committing:

```bash

Format code

cargo fmt --all

Check lints (fail on warnings)

cargo clippy --all-targets -- -D warnings

Ensure tests pass

cargo test

```

Examples

**Example 1: Adding a new repository filter**

```rust

// 1. Add filter to Config in config.rs

pub struct Config {

pub filter_archived: bool,

pub filter_private: bool,

pub new_filter_option: bool, // Add this

}

// 2. Implement filtering in github.rs

impl GitHubClient {

pub async fn list_repos(&self, config: &Config) -> Result<Vec<Repository>> {

let repos = self.octocrab.current().list_repos_for_authenticated_user()

.send()

.await?;

// Apply new filter

let filtered = repos.into_iter()

.filter(|r| !config.new_filter_option || meets_criteria(r))

.collect();

Ok(filtered)

}

}

// 3. Add UI toggle in ui/app.rs

// 4. Test with cargo test and cargo run

```

**Example 2: Running tests for specific module**

```bash

Test only the auth module

cargo test auth::

Test a specific function

cargo test test_repo_action_parse

Run with verbose output

cargo test -- --nocapture

```

Important Notes

Constraints