{"id":21503903,"url":"https://github.com/avegancafe/juliet","last_synced_at":"2025-10-07T06:19:12.787Z","repository":{"id":78971045,"uuid":"133795298","full_name":"avegancafe/Juliet","owner":"avegancafe","description":"a dev setup","archived":false,"fork":false,"pushed_at":"2025-09-29T13:50:55.000Z","size":13648,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-29T15:35:12.733Z","etag":null,"topics":["fish-shell","kitty","kitty-terminal","nvim","setup","vim"],"latest_commit_sha":null,"homepage":"","language":"Fennel","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/avegancafe.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2018-05-17T10:06:43.000Z","updated_at":"2025-09-19T20:21:20.000Z","dependencies_parsed_at":"2024-01-24T21:27:51.914Z","dependency_job_id":"40c709b1-9de6-47cd-825a-d72d8c91cc3c","html_url":"https://github.com/avegancafe/Juliet","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/avegancafe/Juliet","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/avegancafe%2FJuliet","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/avegancafe%2FJuliet/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/avegancafe%2FJuliet/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/avegancafe%2FJuliet/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/avegancafe","download_url":"https://codeload.github.com/avegancafe/Juliet/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/avegancafe%2FJuliet/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278729495,"owners_count":26035667,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-07T02:00:06.786Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["fish-shell","kitty","kitty-terminal","nvim","setup","vim"],"created_at":"2024-11-23T18:31:31.743Z","updated_at":"2025-10-07T06:19:12.782Z","avatar_url":"https://github.com/avegancafe.png","language":"Fennel","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Juliet\n\nA comprehensive dotfiles repository for macOS development environment setup. Manages configurations for terminal applications, editors, system utilities, and development tools through symlinked dotfiles and automated setup scripts.\n\n## Setup\n\nTo set up Juliet, run: \n```bash\n$ git clone --recursive git@github.com:avegancafe/Juliet ~/.config/Juliet\n$ ~/.config/Juliet/bin/juliet-bootstrap\n```\n\n## Available Tools and Functions\n\n### System Setup \u0026 Management\n\n**Core Binaries:**\n- **`juliet-bootstrap`** - Main setup and update script\n  - Installs Homebrew and dependencies\n  - Updates Juliet repository from git\n  - Runs `brew bundle` to install packages\n  - Sets up symlinks using GNU Stow\n  - Usage: `~/.config/Juliet/bin/juliet-bootstrap`\n\n**System Utilities:**\n- **`reindex-spotlight`** - macOS Spotlight reindexing\n- **`update-kitty`** - Kitty terminal updater\n- **`envsource`** - Environment variable sourcing\n- **`sudo`** - Enhanced sudo wrapper\n\n### Git \u0026 Version Control\n\n**Git Binaries:**\n- **`better-branch`** - Enhanced git branch viewer\n  - Shows colorized branch list with commit counts\n  - Displays ahead/behind status relative to main branch\n  - Shows last commit info for each branch\n\n- **`delete-current-branch`** - Safe branch deletion\n  - Switches to main branch and deletes current branch\n  - Logs deleted commit SHA to `~/.delog` for recovery\n\n- **`git-recreate`** - Branch recreation utility\n  - Deletes current branch and recreates it from latest main\n  - Useful for starting fresh while keeping branch name\n\n- **`git-hoard/`** - Git repository organization tool (Node.js project)\n\n**Git Functions:**\n- **`g`** - Short alias for git\n- **`current-branch`** - Get current git branch name\n- **`cb`** - Copy current branch name to clipboard\n- **`current-sha`** - Get current commit SHA\n- **`default-branch`** - Get repository's default branch\n- **`gdiff`** - Git diff wrapper\n- **`gut`** - Git status shortcut\n- **`clone`** - Enhanced git clone\n\n**Git Aliases:**\n- **`git a`** - Add files to staging\n- **`git ape`** - Amend previous commit and force push with lease\n- **`git b`** / **`git bbranch`** - Show enhanced branch list (uses better-branch)\n- **`git clean-branches`** - Delete all branches except master/main\n- **`git clean-merged`** / **`git cm`** - Delete branches that have been merged\n- **`git co`** - Checkout branch/commit\n- **`git com`** - Commit changes\n- **`git cp`** - Cherry-pick commits\n- **`git del`** - Delete current branch safely (uses delete-current-branch)\n- **`git diff-branch`** - Show diff from fork point with master\n- **`git fixup`** - Create fixup commit for interactive rebase\n- **`git fo`** - Fetch from origin\n- **`git judge`** - Enhanced blame with whitespace/move detection\n- **`git main`** - Switch to main/master branch automatically\n- **`git o`** / **`git open`** - Open repository in GitHub\n- **`git pdiff`** - Pretty diff using bat with syntax highlighting\n- **`git pf`** - Push with force-with-lease (safer force push)\n- **`git pu`** - Pull changes\n- **`git rb`** - Rebase commits\n- **`git re`** - Restore files\n- **`git s`** - Switch branches\n- **`git squash`** - Interactive rebase to squash commits against main\n- **`git staash`** - Stash all changes including untracked files\n- **`git staged`** - Show staged changes\n- **`git su`** - Update submodules recursively\n- **`git t`** - Ticket (custom command)\n- **`git up`** - Push changes\n\n### Editor \u0026 Development Environment\n\n**Editor Tools:**\n- **`nv`** - Launch Neovide GUI editor, auto-installs if missing\n- **`vim`** - Alias for nvim\n- **`cursor`** - Launch Cursor editor\n\n**Neovim Management:**\n- **`nvim-refresh-plugins`** - Neovim plugin manager\n  - Clears lazy.nvim plugin cache\n  - Restores plugins from lock file\n\n### File Operations \u0026 Navigation\n\n**Enhanced File Tools:**\n- **`cat`** - Enhanced cat using `bat` with syntax highlighting\n- **`ls`** - Enhanced ls using `eza` with better formatting\n\n**Workspace Management:**\n- **`work`** - Interactive workspace/directory switcher\n  - Reads from `~/.workspaces` and `~/.workspaces__local`\n  - Supports `@workspace` (directories with subdirs) and `@dir` (specific dirs)\n  - Uses gum for interactive selection\n  - Setup example:\n    ```\n    @workspace ~/workspace\n    @dir ~/.config/nvim\n    ```\n\n### Development \u0026 DevOps Tools\n\n**GitHub Integration:**\n- **`run`** - GitHub Actions workflow runner\n  - Runs workflows with optional current branch\n  - Watches workflow execution\n  - Usage: `run \u003cworkflow-name\u003e [-c/--current] [-a/--args=\"args\"]`\n\n- **`gist-to-pdf`** - GitHub Gist converter\n  - Clones gists and converts to PDF format\n  - Usage: `gist-to-pdf \u003cgist-id\u003e`\n\n**Container \u0026 Cloud Tools:**\n- **`dc`** - Docker Compose shortcut\n- **`kc`** - kubectl shortcut\n\n**Language-Specific Tools:**\n- **`node`** - Node.js wrapper\n- **`has-pipfile`** - Check for Python Pipfile\n\n### Monitoring \u0026 Utilities\n\n**System Monitoring:**\n- **`logs`** - System log viewer\n- **`watch`** - File watching utility\n- **`pv`** - Process viewer\n- **`st`** - Status checker\n\n**General Utilities:**\n- **`note`** - Note-taking utility\n\n## Downloads\n\n- [Iosevka](https://drive.google.com/file/d/1kizplo6YXxxNMWzfh6cUVAGRiJq4jsTR/view?usp=share_link)\n- [Logitech Options](https://www.logitech.com/en-us/product/options)\n- [DisplayLink](https://www.displaylink.com/downloads/macos)\n\n## Architecture\n\n- `symlinked/` - Contains all dotfiles organized by target location\n  - `symlinked/config/` - Files that go in ~/.config/\n  - `symlinked/home/` - Files that go in ~/\n- `bin/` - Custom utility scripts and tools\n- `etc/` - Assets (fonts, themes, wallpapers, keyboard layouts)\n- `Brewfile` - Homebrew package definitions\n\nAll Fish shell functions are auto-loaded alphabetically from `symlinked/config/fish/functions/aliases/` and integrate with the broader Juliet ecosystem for a cohesive development environment.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Favegancafe%2Fjuliet","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Favegancafe%2Fjuliet","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Favegancafe%2Fjuliet/lists"}