Skip to main content

Code Compass

Deprecated. This package is being retired and replaced by ppicker (command pp): a much faster terminal picker built for i3/sway. Move your projects over with code-compass migrate. The code-compass name on PyPI will later be handed over to another project, so migrate while this release is still available. Details: migration guide.

Screenshot

A simple and intuitive desktop application to manage your coding projects, built with Python and Qt (using PySide6).

Features

  • Organize projects into categories.
  • Quickly access project information, such as project name, path, and last opened date.
  • Easily add, create, delete, and run projects with built-in buttons.
  • Customize your project's attributes like name, path, and category.
  • Choose between different IDEs, such as PyCharm and Visual Studio Code.
  • Tab-based navigation for easy access to different project categories.

Installation

pip install code-compass

Usage

code-compass

Configuration

Code Compass uses a configuration file to store your preferences. The configuration file is located at ~/.config/code_compass/config.yaml.

Example

# IDE commands to run when clicking the "Run" button.
ide_commands:
  - pycharm
  - code

# Default path to start browsing when adding or creating a new project.
projects_path: /home/username/Projects

# Cookiecutter template to use when creating a new project.
cookiecutter: https://github.com/roman-right/py-template

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Metadata

Release files for code-compass 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for code-compass 0.2.0
File Size Uploaded Provenance Actions
code_compass-0.2.0.tar.gz 9.5 kB With provenance Details for code_compass-0.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for code-compass 0.2.0
File Interpreter ABI Platform Actions
code_compass-0.2.0-py3-none-any.whl Python 3 none any Details for code_compass-0.2.0-py3-none-any.whl

Total release size: 20.8 kB

Release files / code_compass-0.2.0.tar.gz

Download URL code_compass-0.2.0.tar.gz
Size 9.5 kB
Tags Source
SHA-256 checksum
How to use checksums
da13cf57c76f203be4c713d6a3a78bdaca1f238fddcaba21f45daf9c6b7eb5aa
BLAKE2b-256 checksum
How to use checksums
cfa267da7ce8d4f7206457f7f7cc6985b5a6dd4488ea6fb35205901e2753712f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 12, 2026.

Transparency log

Release files / code_compass-0.2.0-py3-none-any.whl

Download URL code_compass-0.2.0-py3-none-any.whl
Size 11.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
45380767909ee15c068ca73c81d271a01773a6318b22cfe7518f2c1850d57283
BLAKE2b-256 checksum
How to use checksums
1ae2ba092f2854d8e7a08ecf47320df5f44a7cc643583709231fd12925cfcd28
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 12, 2026.

Transparency log

Security for code-compass 0.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for code_compass-0.2.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 12, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page