‹ Reports
The Dispatch

OSS Report: nikitabobko/AeroSpace


AeroSpace Faces Persistent Window Management Challenges Amidst Active Development

AeroSpace, a tiling window manager for macOS, continues to grapple with window management inconsistencies and user requests for enhanced functionality, as evidenced by the high volume of related issues. The project is actively addressing these concerns, but the recurring nature of these issues suggests a need for more robust solutions.

Recent Activity

Recent issues highlight user frustrations with window management, particularly with applications like qutebrowser and Chrome, and challenges in managing multiple windows across workspaces and monitors. Notable issues include #449 focusing on application window focus, #448 requesting touchpad gesture support, and #446 concerning node layout persistence when switching monitors. These issues collectively indicate a critical need for improved handling of application windows and workspace management.

Development Team and Recent Activity

The team's activities reflect a focus on stability, usability improvements, and comprehensive documentation.

Of Note

Quantified Reports

Quantify Issues



Recent GitHub Issues Activity

Timespan Opened Closed Comments Labeled Milestones
7 Days 25 13 37 15 1
30 Days 109 70 229 70 1
90 Days 200 129 479 129 1
All Time 422 279 - - -

Like all software activity quantification, these numbers are imperfect but sometimes useful. Comments, Labels, and Milestones refer to those issues opened in the timespan in question.

Quantify commits



Quantified Commit Activity Over 30 Days

Developer Avatar Branches PRs Commits Files Changes
Nikita Bobko 4 0/0/0 42 74 3283
Jake Langford 1 1/0/1 6 32 199
Zhizhen He 1 1/1/0 1 1 2
W. (graywolf) 0 1/0/1 0 0 0
Janusz Bossy (YANOUSHek) 0 1/0/1 0 0 0

PRs: created by that dev and opened/merged/closed-unmerged during the period

Detailed Reports

Report On: Fetch issues



Recent Activity Analysis

The AeroSpace project has seen a significant number of recent issues, with 143 currently open. Notably, there are recurring themes around window management inconsistencies, particularly with applications like qutebrowser and various IDEs, as well as user requests for enhanced functionality such as workspace management and layout customization. There are also several reports of crashes and performance issues, particularly when interacting with external monitors or specific applications.

A common thread among the issues is the challenge users face when trying to manage multiple windows across different workspaces and monitors, especially regarding how certain applications' windows are treated (e.g., floating vs. tiled). The project appears to be actively addressing these concerns, but the volume of related issues suggests that more robust solutions may be needed.

Issue Details

Here are the most recently created and updated issues:

  1. Issue #449: Focus next window of the current application

    • Priority: Normal
    • Status: Open
    • Created: 0 days ago
    • Updated: 0 days ago
  2. Issue #448: Feature Request: Add Support for 3-Finger Touchpad Gesture to Navigate Active Spaces

    • Priority: Normal
    • Status: Open
    • Created: 1 day ago
    • Updated: 0 days ago
  3. Issue #447: Move to the workspace where a detected application is opened

    • Priority: Normal
    • Status: Open
    • Created: 1 day ago
    • Updated: 0 days ago
  4. Issue #446: Persist the node layout even when switching monitors

    • Priority: Normal
    • Status: Open
    • Created: 2 days ago
    • Updated: 0 days ago
  5. Issue #445: Actively check for closed windows on every "refresh session"

    • Priority: Problem
    • Status: Open
    • Created: 2 days ago
    • Updated: 2 days ago
  6. Issue #444: Add --count flags to list-* commands

    • Priority: Feature Request
    • Status: Open
    • Created: 2 days ago
    • Updated: 0 days ago
  7. Issue #443: Issue with lettered workspace switching

    • Priority: Normal
    • Status: Closed
    • Created: 2 days ago
    • Updated: 2 days ago
  8. Issue #440: Chrome PWAs have an empty title (and crash list-windows --all --format "%{window-title}")

    • Priority: Bug
    • Status: Open
    • Created: 3 days ago
    • Updated: 0 days ago
  9. Issue #439: Add documentation for the menu bar

    • Priority: Normal
    • Status: Open
    • Created: 3 days ago
    • Updated: 1 day ago
  10. Issue #438: Allow querying workspace layout

    • Priority: Feature Request
    • Status: Open
    • Created: 3 days ago
    • Updated: 2 days ago

Analysis of Notable Issues

  • Several recent issues highlight user frustrations with window management, particularly regarding how certain applications (like qutebrowser and Chrome) behave when opened in different states (floating vs. tiled). This indicates a need for improved handling of application windows based on their specific behaviors.

  • The request for features like support for touchpad gestures and better workspace management suggests that users are looking for more intuitive ways to interact with their applications and manage their workflow.

  • Issues related to crashes when interacting with specific applications or configurations (e.g., using multiple monitors) point to potential stability concerns that could affect user experience significantly.

  • The presence of feature requests alongside bugs suggests that while users appreciate the functionality offered by AeroSpace, they also see room for improvement in usability and flexibility.

  • The high volume of issues related to workspace management indicates that this is a critical area for development focus going forward, especially as users transition from other window managers like Yabai or i3.

This analysis reflects a vibrant community actively engaging with the AeroSpace project, providing valuable feedback that can guide future development efforts.

Report On: Fetch pull requests



Overview

The analysis of the pull requests (PRs) for the AeroSpace project reveals a total of 26 closed PRs, with a mix of accepted, rejected, and draft submissions. The most recent PR focuses on improving the integration of the Swift Package Manager (SPM), while several others address minor fixes and feature proposals.

Summary of Pull Requests

  1. PR #424: Improve usage of swift package manager
    Closed 4 days ago. This PR enhances the project structure to better utilize SPM, reducing reliance on Xcode. It introduces significant changes such as replacing the bridging header with a module map and modifying the app entry point. Notably, it was submitted as a draft for review and included discussions about coding standards.

  2. PR #416: Fix typo
    Closed 9 days ago. A minor correction in documentation that was quickly merged.

  3. PR #389: Added support for hyper and meh modifiers
    Closed 12 days ago. This PR proposed adding two new modifier keys but was rejected due to concerns about standardization and potential future complications with hardcoding key combinations.

  4. PR #362: default-config: Do not use -n for terminal
    Closed 18 days ago. This PR aimed to improve terminal behavior by changing how new windows are opened but was rejected due to limitations identified in its implementation.

  5. PR #334: docs: Add Monitor resolution impacts into the guide
    Closed 37 days ago. Proposed documentation improvements regarding monitor resolutions but was ultimately rejected as it did not provide sufficient clarity or relevance.

  6. PR #290: implement balance-sizes command
    Closed 65 days ago. Introduced a command to set uniform sizes for windows sharing a common parent but faced several comments regarding code quality and documentation before being merged.

  7. PR #275: Reduce workspace switching flicker
    Closed 72 days ago. This PR addressed a visual issue during workspace switching and was accepted with minor adjustments.

  8. PR #255: Fix typo + links to on-window-detected on default-config.toml
    Closed 77 days ago. Merged only the typo fix; additional documentation changes were deemed unnecessary.

  9. PR #240: fix typo
    Closed 89 days ago. Another minor typo fix that was promptly merged.

  10. PR #234: docs: add alfred workflow
    Closed 94 days ago. This PR was rejected without further elaboration.

  11. PR #227: Mention Raycast extension
    Closed 101 days ago. Accepted, indicating an enhancement to documentation or features related to Raycast.

  12. PR #213: fix(docs): Fix Colemak keyboard distribution
    Closed 110 days ago. Rejected due to concerns over mapping accuracy in keyboard layouts.

13-26. Additional PRs (from #198 down to #1) included various enhancements, fixes, and documentation updates, with many being accepted or merged after minor revisions.

Analysis of Pull Requests

The pull requests for the AeroSpace project reflect an active development environment focused on enhancing functionality while maintaining code quality and user experience. A significant theme is the integration of Swift Package Manager (SPM), highlighted by PR #424, which indicates a shift towards modernizing the build process and reducing dependencies on Xcode's project management system. This change is crucial as it simplifies the setup for developers, allowing them to build and run the application more efficiently without complex scripts.

The diversity of PRs also showcases community engagement, with contributors addressing both minor issues—like typos in documentation—and more substantial feature requests, such as new modifier keys (PR #389). However, the rejection of some proposals illustrates a careful consideration of what features align with the project's philosophy of avoiding unnecessary complexity and maintaining stability as it approaches its first stable release.

Notably, there is a recurring emphasis on documentation improvements throughout the PRs, which aligns with AeroSpace's commitment to user-friendliness through clear guides and configuration examples. However, some proposed changes were rejected due to perceived redundancy or lack of clarity, suggesting that while community input is valued, there is also a strong editorial oversight to maintain focus on essential information.

The presence of discussions within PRs indicates an active dialogue among contributors regarding coding standards and best practices—particularly evident in PR #424 where formatting tools like swift-format were debated but ultimately deemed less critical at this stage of development by lead maintainer Nikita Bobko.

In summary, while AeroSpace has made significant strides in its development through community contributions, there remains a need for ongoing refinement in both code quality and user documentation as it prepares for broader adoption post-beta phase. The project's focus on practical enhancements over aesthetic changes positions it well for attracting advanced users who prioritize functionality in their window management solutions on macOS.

Report On: Fetch commits



Repo Commits Analysis

Development Team and Recent Activity

Team Members:

  • Nikita Bobko (nikitabobko)

    • Recent Activity:
    • Committed 42 times with 3283 changes across 74 files in the last 30 days.
    • Key contributions include:
    • Minor updates and bug fixes (e.g., fixing workspace calculations, improving focus logic).
    • Significant enhancements to project structure and build scripts to support Swift Package Manager (SPM).
    • Documentation updates and improvements in command parsing.
    • Collaborated with Jake Langford on a pull request to remove dependency on bundle info for running outside the bundle.
    • Ongoing work on various features, including shell completion and window management improvements.
  • Jake Langford (jakenvac)

    • Recent Activity:
    • Made 6 commits with 199 changes across 32 files.
    • Notable contribution includes a pull request that co-authored with Nikita Bobko, focusing on removing dependencies and updating scripts for better build management.
  • Zhizhen He (hezhizhen)

    • Recent Activity:
    • Made 1 commit with 2 changes.
    • Fixed a typo in documentation.
  • YANOUSHek

    • Recent Activity:
    • No recent commits but has an open pull request.
  • graywolf

    • Recent Activity:
    • No recent commits but has an open pull request.

Patterns and Themes:

  • High Activity Level: Nikita Bobko is the primary contributor, demonstrating high engagement with frequent commits focused on both feature development and bug fixes.
  • Collaborative Efforts: Collaboration is evident, particularly between Nikita Bobko and Jake Langford, indicating a team-oriented approach to problem-solving and feature implementation.
  • Focus on Stability and Usability: The recent activities reflect a commitment to enhancing the usability of the AeroSpace application while maintaining stability through careful refactoring and bug fixes.
  • Documentation Emphasis: There is a notable effort in updating documentation alongside code changes, which is crucial for user guidance given the complexity of the project.
  • Feature Development: Continuous enhancements are being made to core functionalities such as window management, command-line interface capabilities, and configuration flexibility, aligning with the project's goals of catering to advanced users.

Conclusion:

The development team is actively engaged in refining the AeroSpace project, with a strong focus on collaboration, usability improvements, and comprehensive documentation. The ongoing efforts suggest a robust trajectory towards achieving a stable release ahead of version 1.0.