@kalenkevich/agent_007 0.0.1 → 0.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +73 -0
- package/package.json +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
# Agent 007 🕵️♂️
|
|
2
|
+
|
|
3
|
+
**Yet another AI agent coding harness.**
|
|
4
|
+
|
|
5
|
+
Agent 007 is an interactive AI assistant designed to help you with coding tasks. It leverages Google's Gemini models to understand your codebase, execute tools, and assist you in development.
|
|
6
|
+
|
|
7
|
+
## Features
|
|
8
|
+
|
|
9
|
+
- 🤖 **Interactive CLI**: Engage in a dialogue with the agent to solve coding problems.
|
|
10
|
+
- 🛠️ **Tool Execution**: The agent can read/write files, search code (grep, find), and run commands (with your approval).
|
|
11
|
+
- 🔍 **Project Awareness**: Scans your project to understand the language, framework, and structure for better assistance.
|
|
12
|
+
- 🧠 **Context Compaction**: Automatically manages chat history to stay within model context limits.
|
|
13
|
+
- 🔄 **Session Management**: Persists session data for continuity.
|
|
14
|
+
- 🎯 **Planning Agent**: (In Progress) Can create and execute plans for complex tasks.
|
|
15
|
+
|
|
16
|
+
## Installation
|
|
17
|
+
|
|
18
|
+
You can install it from npm (if published):
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
npm install @kalenkevich/agent_007 -g
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
Or run it directly from the source:
|
|
25
|
+
|
|
26
|
+
1. Clone the repository:
|
|
27
|
+
```bash
|
|
28
|
+
git clone https://github.com/kalenkevich/agent_007.git
|
|
29
|
+
cd agent_007
|
|
30
|
+
```
|
|
31
|
+
2. Install dependencies:
|
|
32
|
+
```bash
|
|
33
|
+
npm install
|
|
34
|
+
```
|
|
35
|
+
3. Build the project:
|
|
36
|
+
```bash
|
|
37
|
+
npm run build
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
## Usage
|
|
41
|
+
|
|
42
|
+
Set your Gemini API key as an environment variable:
|
|
43
|
+
|
|
44
|
+
```bash
|
|
45
|
+
export GEMINI_API_KEY="your-api-key"
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
_(Alternatively, it will look for `GOOGLE_API_KEY`)_
|
|
49
|
+
|
|
50
|
+
Run the agent:
|
|
51
|
+
|
|
52
|
+
```bash
|
|
53
|
+
# If installed globally
|
|
54
|
+
agent007
|
|
55
|
+
|
|
56
|
+
# Or from the repository root
|
|
57
|
+
npm start
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
## Development
|
|
61
|
+
|
|
62
|
+
### Scripts
|
|
63
|
+
|
|
64
|
+
- `npm run build`: Compiles TypeScript source code.
|
|
65
|
+
- `npm start`: Runs the agent in debug mode.
|
|
66
|
+
- `npm test`: Runs all tests (unit, integration, e2e).
|
|
67
|
+
- `npm run test:unit`: Runs only unit tests.
|
|
68
|
+
- `npm run test:integration`: Runs integration tests.
|
|
69
|
+
- `npm run test:e2e`: Runs end-to-end tests.
|
|
70
|
+
|
|
71
|
+
## License
|
|
72
|
+
|
|
73
|
+
ISC
|