Automic VaultAutomic Vault

brew

使用 Homebrew 安装 virtualfish

查看 virtualfish 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

安装

其他安装命令

macOS

Homebrew已验证 · 100%
brew install virtualfish

local Homebrew formula metadata

概览

软件包摘要

Python virtual environment manager for the fish shell

历史

项目历史与用法

VirtualFish is a Python virtual-environment manager for the fish shell. It occupies the same niche as virtualenvwrapper, but for fish users who want `vf` commands, prompt integration, optional auto-activation, and project helpers that fit fish's syntax and startup model.

项目历史

The upstream README says VirtualFish is maintained by Justin Mayer and was originally created by Daisy Leigh Brenecki. Public discussion from 2012 describes it as a fish-shell replacement inspired by Doug Hellmann's virtualenvwrapper, which matches the project's long-running positioning as fish-native virtualenv workflow glue.

PyPI's visible release history starts with 1.0.0a1 in March 2015, while the current repository documents fish 3.1 or newer as a requirement and points users to the Read the Docs manual. The 2.x line added the current plugin-oriented shape, including project management, environment-variable automation, and compatibility aliases.

采用历史

VirtualFish is a niche tool by design: its audience is Python developers who already prefer fish over bash or zsh. Its sustained packaging in PyPI and Homebrew, and its explicit IRC/support channel alongside fish, show a small but persistent shell-specific community rather than broad mainstream Python tooling dominance.

The tool has also aged alongside Python's built-in fish activation scripts. Python's venv module can generate `activate.fish`, but VirtualFish remains useful when users want a named environment registry, `vf new` and `vf activate`, automatic activation from `.venv` marker files, or virtualenvwrapper-style habits in fish.

使用方式

The quickstart is intentionally short: install the package with pip, run `vf install`, add VirtualFish to the prompt if desired, then create an environment with a command such as `vf new myvirtualenv`. Users can enable plugins for auto-activation, projects, environment variables, and compatibility aliases.

The package is most often used interactively rather than as a dependency of applications. Its value is reducing shell friction: fish users get completions, prompt state, and activation/deactivation behavior without sourcing bash-oriented scripts.

为什么软件包爱好者会关心

VirtualFish is package-nerd significant because it preserves an older virtualenvwrapper style of environment management inside a shell that deliberately differs from POSIX shell syntax. It is a reminder that packaging workflows are shaped as much by shell ergonomics as by Python packaging standards.

时间线

  • 2012: Daisy Leigh Brenecki publicly described starting a fish-shell replacement for virtualenvwrapper-style workflows.
  • 2015-03-22: The earliest VirtualFish files currently listed on PyPI were uploaded.
  • 2020-04-01: GitHub releases list VirtualFish 2.0.0.
  • 2024-05-13: GitHub releases list VirtualFish 2.5.9.

Related projects

  • virtualenv provides the underlying environment model. virtualenvwrapper is the older Bourne-shell-oriented inspiration. Python's standard-library venv module provides fish activation scripts for simpler workflows.

来源

  • Python venv activation documentation: https://docs.python.org/3/library/venv.html
  • Stack Overflow answer by Daisy Leigh Brenecki describing early VirtualFish: https://stackoverflow.com/questions/10956335/how-to-get-virtualenv-to-work-with-fish-shell
  • VirtualFish GitHub README: https://github.com/justinmayer/virtualfish
  • VirtualFish PyPI project: https://pypi.org/project/virtualfish/
  • VirtualFish documentation: https://virtualfish.readthedocs.io/
  • VirtualFish plugins documentation: https://virtualfish.readthedocs.io/en/latest/plugins.html

安全态势

风险级别:yellow

generalized runtime or code generation signal.

风险分类器

yellow 风险 · 中 置信度 · runtime

原因

  • generalized runtime or code generation signal

信号

  • text:shell

安装行为

  • formula 元数据中未记录 Homebrew post-install 钩子。
  • Homebrew bottle 元数据适用于 6 个平台目标。
  • 安装时包含 2 个运行时依赖。

建议审查

在无人值守的代理使用前,请检查该工具是否读取明文凭据、写入远程状态、发布制品或调用插件。

local files

Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.

Configuration files

Config paths the tool may read or write during local use.

Unix
$XDG_CONFIG_HOME/fish/conf.d/virtualfish-loader.fish~/.config/fish/conf.d/virtualfish-loader.fish

可执行文件

已安装的可执行文件

命令类型暴露范围备注
vfcli全局可执行文件

新鲜度

版本和新鲜度

这些信号区分页生成时间、软件包管理器活动和上游发布比较。只有存在证据 URL 和可比较版本时,才会提示版本落后。

页面生成时间2026-07-10
管理器版本2.5.9
管理器更新时间
本地数据OK
上游not checked
检测到的最新版本未检测到

https://virtualfish.readthedocs.io/en/latest/

安装元数据

软件包元数据

软件包键brew:virtualfish
版本2.5.9
软件包管理器Homebrew
软件包管理器页面https://formulae.brew.sh/formula/virtualfish
主页https://virtualfish.readthedocs.io/en/latest/
仓库https://github.com/justinmayer/virtualfish
上游文档https://virtualfish.readthedocs.io/en/latest
许可证MIT
源码归档https://files.pythonhosted.org/packages/1f/4e/343d044d61e80a44163d15ad2f6ca20eca0cb4fef4058caf8e5e55fc3dd9/virtualfish-2.5.9.tar.gz
依赖fish, python@3.14
Bottle可用 (于 arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux)
Homebrew post-install未定义
服务未声明
注意事项To activate virtualfish, run the following in a fish shell: vf install

注册表事实

源数据库详情

Source DatabaseHomebrew formula API
Taphomebrew/core
Full Namevirtualfish
Version Scheme0
Revision3
Head VersionHEAD
Bottle Stable Root URLhttps://ghcr.io/v2/homebrew/core
Deprecatedno
Disabledno
Keg Onlyno
URL Keys
  • head
  • stable

来源线索

由仓库数据生成

此页面由 av-webscripts/generate-pkg-sqlite.py 生成的私有软件包 SQLite 工件提供。

使用的来源

  • Geiger risk classifier
  • Nucleus package database
  • av.db category and tag curation
  • cross-ecosystem install command graph
  • curated configuration and credential file locations
  • curated package history
  • package relationship graph
  • package version freshness
  • package-page enrichment