FirePass

A Firefox password manager extension powered by pass (the standard Unix password manager).

Overview

FirePass bridges your Firefox browser with your existing pass password store, allowing you to:

• 🔐 Access your passwords directly from Firefox
• 🔍 Search and filter credentials
• ✨ Auto-fill login forms
• ➕ Save new credentials to your pass store
• 🎲 Generate secure passwords
• ⌨️ Use keyboard shortcuts for quick access

Architecture

The project consists of two main components:

1. Firefox Extension (extension/) - Vue 3 based browser extension
2. Native Host (backend/) - Go application that communicates with pass

Prerequisites

• pass installed and configured with GPG
• Go 1.21+ (for building the native host)
• Node.js 18+ (for building the extension)
• Firefox 91+

Installation

Quick Install

# Clone the repository
git clone https://github.com/yourusername/firepass.git
cd firepass

# Build everything
make build

# Install the native messaging host
make install-native-host

Manual Installation

1. Build the Native Host

cd backend
go build -o firepass ./cmd/main

2. Install the Native Host

Copy the binary to a location in your PATH:

sudo cp firepass /usr/local/bin/
# or for user-local installation:
mkdir -p ~/.local/bin
cp firepass ~/.local/bin/

Create the native messaging manifest:

mkdir -p ~/.mozilla/native-messaging-hosts/

# Edit the path in the manifest to point to your firepass binary
cat > ~/.mozilla/native-messaging-hosts/com.firepass.host.json << EOF
{
  "name": "com.firepass.host",
  "description": "FirePass Native Messaging Host",
  "path": "/usr/local/bin/firepass",
  "type": "stdio",
  "allowed_extensions": [
    "firepass@example.com"
  ]
}
EOF

3. Build the Extension

cd extension
npm install
npm run build

4. Load the Extension in Firefox

1. Open Firefox and navigate to about:debugging
2. Click "This Firefox" in the sidebar
3. Click "Load Temporary Add-on..."
4. Navigate to extension/dist/ and select manifest.json

For permanent installation, you'll need to sign the extension through Mozilla Add-ons.

Usage

Popup Interface

Click the FirePass icon in your toolbar to:

• View credentials for the current website
• Search all stored passwords
• Add new credentials
• Copy passwords to clipboard

Keyboard Shortcuts

Shortcut	Action
Ctrl+Shift+P / Cmd+Shift+P	Open FirePass popup
Ctrl+Shift+L / Cmd+Shift+L	Auto-fill credentials

Pass Store Format

FirePass reads and writes credentials in the standard pass format:

mysecretpassword
username: user@example.com
url: https://example.com
notes: Additional notes here

The first line is always the password. Subsequent lines can contain metadata in key: value format.

Development

Backend Development

cd backend

# Run tests
go test ./...

# Build
go build -o firepass ./cmd/main

# Format code
go fmt ./...

Extension Development

cd extension

# Install dependencies
npm install

# Development mode with hot reload
npm run dev

# Build for production
npm run build

# Lint code
npm run lint

Project Structure

firepass/
├── backend/
│   ├── cmd/
│   │   └── main/
│   │       └── main.go              # Entry point
│   ├── internal/
│   │   ├── domain/
│   │   │   ├── credential/          # Credential aggregate
│   │   │   │   ├── credential.go    # Entity and value objects
│   │   │   │   └── repository.go    # Repository interface
│   │   │   └── errors.go            # Domain errors
│   │   ├── application/
│   │   │   ├── dto/
│   │   │   │   └── messages.go      # Data transfer objects
│   │   │   └── service/
│   │   │       └── credential_service.go  # Application services
│   │   └── infrastructure/
│   │       ├── pass/
│   │       │   └── repository.go    # Pass store implementation
│   │       └── messaging/
│   │           └── handler.go       # Native messaging handler
│   ├── native-messaging/
│   │   └── com.firepass.host.json   # Manifest template
│   └── go.mod
├── extension/
│   ├── src/
│   │   ├── popup/                   # Vue popup UI
│   │   │   ├── components/          # Vue components
│   │   │   ├── services/            # Messaging service
│   │   │   ├── App.vue
│   │   │   ├── main.js
│   │   │   └── index.html
│   │   ├── background/
│   │   │   └── background.js        # Background script
│   │   └── content/
│   │       └── content.js           # Content script for autofill
│   ├── public/
│   │   ├── manifest.json            # Firefox manifest
│   │   └── icons/
│   ├── package.json
│   └── vite.config.js
├── Makefile
└── README.md

Security Considerations

• GPG Integration: FirePass relies on your existing GPG setup. Ensure your GPG agent is properly configured.
• Clipboard: Passwords copied to clipboard are automatically cleared after a configurable timeout (default: 30 seconds).
• Native Messaging: Communication between the extension and native host uses Firefox's secure native messaging protocol.
• No Remote Storage: All passwords remain in your local pass store.

Troubleshooting

"Unable to connect to native host"

1. Verify the native host is installed:

   which firepass

2. Check the manifest exists:

   cat ~/.mozilla/native-messaging-hosts/com.firepass.host.json

3. Verify the path in the manifest matches your firepass installation.

4. Ensure pass is working:

   pass ls

"Password store is not initialized"

Initialize your pass store if you haven't already:

pass init <your-gpg-key-id>

Extension not loading

• Check the browser console (Ctrl+Shift+J) for error messages
• Ensure you're loading from the dist/ directory, not src/

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is open source. See LICENSE file for details.

Acknowledgments

• pass - The standard Unix password manager
• Vue.js - Progressive JavaScript framework
• Vite - Next generation frontend tooling