https://github.com/shaneikennedy/amp.el
Vibe coding in emacs with amp
https://github.com/shaneikennedy/amp.el
amp emacs sourcegraph vibe-coding
Last synced: 4 months ago
JSON representation
Vibe coding in emacs with amp
- Host: GitHub
- URL: https://github.com/shaneikennedy/amp.el
- Owner: shaneikennedy
- Created: 2025-06-06T15:14:05.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-06-06T21:52:17.000Z (4 months ago)
- Last Synced: 2025-06-06T22:31:06.856Z (4 months ago)
- Topics: amp, emacs, sourcegraph, vibe-coding
- Language: Emacs Lisp
- Homepage:
- Size: 3.91 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-amp-code - amp.el - Emacs integration for Amp coding agent. (Uncategorized / Uncategorized)
README
# amp.el
An Emacs interface for the [Amp CLI](https://github.com/sourcegraph/amp) - Sourcegraph's AI-powered coding assistant.
## Features
- **Interactive Terminal Interface**: Launch Amp CLI in a dedicated terminal buffer within Emacs
- **Multi-Project Support**: Automatically manages separate Amp sessions for different projects
- **Intelligent Project Detection**: Works with both `projectile` and `project.el` for project identification
- **Quick Code Actions**: Send selected code to Amp with predefined prompts
- **Smart Process Management**: Automatically handles multiple Amp processes and lets you choose between them
- **Auto-Installation**: Automatically installs Amp CLI via npm if not found
### Multi-Project Capabilities
amp.el excels at managing multiple projects simultaneously:
- **Project-Specific Sessions**: Each project gets its own `*amp-{project-name}*` buffer
- **Automatic Project Detection**: Uses projectile or project.el to identify current project
- **Session Switching**: When no Amp process exists for current project, you can choose from running sessions in other projects
- **Buffer Management**: Clean separation between different project contexts
### Quick Actions
- `amp--fix-region`: Send selected text with "fix this: " prefix
- `amp--improve-region`: Send selected text with "improve this: " prefix
- `amp--explain-region`: Send selected text with "explain this: " prefix
- `amp--prompt-for-region`: Send selected text with custom prompt
- `amp--prompt`: Send custom text to amp
- `amp--switch`: Switch between existing amp buffers
- `amp--kill`: Kill selected amp processes
## Installation
### Using straight.el
Add this to your Emacs configuration:
```elisp
(straight-use-package
'(amp :type git :host github :repo "shaneikennedy/amp.el"))
```
### Manual Installation
1. Clone the repository:
```bash
git clone https://github.com/shaneikennedy/amp.el.git
```
2. Add to your Emacs `load-path`:
```elisp
(add-to-list 'load-path "/path/to/amp.el")
(require 'amp)
```
## Usage
### Basic Usage
1. Run `M-x amp` to start Amp in the current project
2. If Amp CLI isn't installed, it will offer to install it via npm
3. The Amp CLI will open in a terminal buffer named `*amp-{project-name}*`
### Code Actions
1. Select code in any buffer
2. Run `M-x amp--fix-region` to send code with "fix this: " prefix
3. Run `M-x amp--improve-region` to send code with "improve this: " prefix
4. Run `M-x amp--explain-region` to send code with "explain this: " prefix
5. Run `M-x amp--prompt-for-region` to send code with custom prompt
### Additional Commands
- `M-x amp--prompt`: Send custom text directly to amp (no region required)
- `M-x amp--kill`: Kill selected amp processes
### Switching Between Sessions
Run `M-x amp--switch` to quickly jump between amp buffers from different projects or sessions.
### Key Bindings (Optional)
Add these to your configuration for quick access:
```elisp
(global-set-key (kbd "C-c a a") 'amp)
(global-set-key (kbd "C-c a f") 'amp--fix-region)
(global-set-key (kbd "C-c a i") 'amp--improve-region)
(global-set-key (kbd "C-c a e") 'amp--explain-region)
(global-set-key (kbd "C-c a p") 'amp--prompt-for-region)
(global-set-key (kbd "C-c a m") 'amp--prompt)
(global-set-key (kbd "C-c a s") 'amp--switch)
(global-set-key (kbd "C-c a k") 'amp--kill)
```
## Requirements
- Emacs 28.1 or later
- Node.js and npm (for Amp CLI installation)
- Optional: `projectile` or `project.el` for enhanced project detection
## License
This project is licensed under the same terms as GNU Emacs.