You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
# 🚀 Codecane - The most powerful coding agent (STAGING)
2
2
3
-
The staging workflow updates these files with the exact version being packaged. They are shipped as workflow artifacts so downstream jobs build and publish binaries from the same commit snapshot.
3
+
**⚠️ This is a staging/beta release for testing purposes.**
4
+
5
+
Codecane is a CLI tool that writes code for you.
6
+
7
+
1. Run `codecane` from your project directory
8
+
2. Tell it what to do
9
+
3. It will read and write to files and run commands to produce the code you want
10
+
11
+
Note: Codecane will run commands in your terminal as it deems necessary to fulfill your request.
12
+
13
+
## Installation
14
+
15
+
To install Codecane (staging), run:
16
+
17
+
```bash
18
+
npm install -g codecane@beta
19
+
```
20
+
21
+
(Use `sudo` if you get a permission error.)
22
+
23
+
## Usage
24
+
25
+
After installation, you can start Codecane by running:
26
+
27
+
```bash
28
+
codecane [project-directory]
29
+
```
30
+
31
+
If no project directory is specified, Codecane will use the current directory.
32
+
33
+
Once running, simply chat with Codecane to say what coding task you want done.
34
+
35
+
## Features
36
+
37
+
- Understands your whole codebase
38
+
- Creates and edits multiple files based on your request
39
+
- Can run your tests or type checker or linter; can install packages
40
+
- It's powerful: ask Codecane to keep working until it reaches a condition and it will.
41
+
42
+
Our users regularly use Codecane to implement new features, write unit tests, refactor code, write scripts, or give advice.
43
+
44
+
## Knowledge Files
45
+
46
+
To unlock the full benefits of modern LLMs, we recommend storing knowledge alongside your code. Add a `knowledge.md` file anywhere in your project to provide helpful context, guidance, and tips for the LLM as it performs tasks for you.
47
+
48
+
Codecane can fluently read and write files, so it will add knowledge as it goes. You don't need to write knowledge manually!
49
+
50
+
Some have said every change should be paired with a unit test. In 2024, every change should come with a knowledge update!
51
+
52
+
## Tips
53
+
54
+
1. Type '/help' or just '/' to see available commands.
55
+
2. Create a `knowledge.md` file and collect specific points of advice. The assistant will use this knowledge to improve its responses.
56
+
3. Type `undo` or `redo` to revert or reapply file changes from the conversation.
57
+
4. Press `Esc` or `Ctrl+C` while Codecane is generating a response to stop it.
58
+
59
+
## Troubleshooting
60
+
61
+
If you are getting permission errors during installation, try using sudo:
62
+
63
+
```
64
+
sudo npm install -g codecane@beta
65
+
```
66
+
67
+
If you still have errors, it's a good idea to [reinstall Node](https://nodejs.org/en/download).
68
+
69
+
## Feedback
70
+
71
+
We value your input! Please email your feedback to `[email protected]`. Thank you for using Codecane!
0 commit comments