Skip to content

Commit 6e6c121

Browse files
committed
Refactor 'code_agent' to 'sidekick' and update README.md 🔄
This commit includes several changes: - The term 'coding companion' in README.md has been replaced with 'coding sidekick' to better reflect the role of AICodeBot. - The 'Repository Management' section in README.md has been renamed to 'Repository / Project Management' and the tasks under this section have been rephrased for clarity. - In the 'sidekick' function in cli.py, a line has been added to direct users to the new 'sidekick.md' document for more information. - The 'code_agent.md' document has been renamed to 'sidekick.md' and updated to provide a comprehensive overview of the 'sidekick' feature. These changes aim to improve the clarity and consistency of the project's documentation.
1 parent d25d3de commit 6e6c121

File tree

3 files changed

+30
-26
lines changed

3 files changed

+30
-26
lines changed

README.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# AI Code Bot 🤖
22

3-
## Your AI-powered coding companion
3+
## Your AI-powered coding sidekick
44

55
AICodeBot is a coding assistant designed to make your coding life easier. With capabilities to perform code reviews, manage dependencies, and even suggest improvements, think of it as your AI version of a pair programmer - a team member that accelerates the pace of development and helps you write better code.
66

@@ -91,16 +91,16 @@ Note: We'll be adding more options for AI models in the future, including those
9191
* [X] **Command-line, installable via pip**: aicodebot can be installed as a Python package using `pip install aicodebot`
9292
* [ ] **Mention the @aicodebot GitHub user**: Mentioning the [@aicodebot](https://pypi.org/project/aicodebot/) GitHub user in a comment will trigger it to perform a task, review code, or pull in an appropriate GIF.
9393
* [ ] **Callable as a GitHub action**: Can be called as a GitHub action to perform tasks on GitHub repositories.
94+
* [ ] **Jupyter Notebook Extension**: Provides a Jupyter Notebook extension that can be used to debug code in the notebook.
9495
* [ ] **Chat**: CLI chat interface that knows the context of your codebase and can answer questions about it. No more going back and forth between ChatGPT and command-line.
9596
* [ ] **Slack Bot**: Interacts with aicodebot via slack, sends notifications, performs tasks, and provides real-time assistance to developers.
9697
* [ ] **Bug Report service integrations**: Listen for bug reports from Sentry, Honeybadger, and other bug reporting tools and automatically create issues, assign them to developers, and notify them via Slack. Eventually: FIX the bug automatically and notify the team.
9798

98-
### Repository Management
99+
### Repository / Project Management
99100

100101
* [ ] **Project best practices**: Suggest things like pre-commit, linting, license, CI/CD, etc. Eventually: Implement them for you.
101-
* [ ] **Handle Stale Issues**: Automatically detects and handles stale issues on GitHub by nudging the responsible parties.
102-
* [ ] **Triage Incoming Issues**: Provides Level 1 triage of incoming issues on GitHub, including tagging, assigning, and responding with FAQs. It could also escalate issues to human developers when necessary.
103-
* [ ] **Rate the complexity of PRs**: Rates the complexity of pull requests and assigns them to developers based on their skill level and context
102+
* [ ] **Manage Github Issues**: Provides Level 1 triage of incoming issues on GitHub, including tagging, assigning, and responding with FAQs. It could also escalate issues to human developers when necessary, and provide nudges for tasks that need more input.
103+
* [ ] **Welcome new contributors**: Automatically welcome new contributors to the project, find out what they're interested in, and suggest issues for them to work on.
104104

105105
### Fun
106106

aicodebot/cli.py

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -245,7 +245,8 @@ def sidekick(task, verbose):
245245
"Due to the token limitations with large language models, the amount of context "
246246
"that can be sent back and forth is limited, and slow. This means that sidekick will struggle with "
247247
"complex tasks and will take longer than a human for simpler tasks.\n"
248-
"Play with it, but don't expect too much. Do you feel like contributing? 😃",
248+
"Play with it, but don't expect too much. Do you feel like contributing? 😃\n"
249+
"See docs/sidekick.md for more information.",
249250
style=warning_style,
250251
)
251252

docs/code_agent.md renamed to docs/sidekick.md

Lines changed: 23 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,16 @@
1-
# AICodeBot Code Agent
1+
# AICodeBot Sidekick
22

3-
Note: The `code` feature does not exist, yet. It is a vision for the future,
4-
ala [README driven development](https://tom.preston-werner.com/2010/08/23/readme-driven-development.html)
3+
⚠️ WARNING: The 'sidekick' feature is currently experimental and, frankly, it sucks right now.
4+
Due to the token limitations with large language models, the amount of context
5+
that can be sent back and forth is limited, and slow. This means that sidekick will struggle with
6+
complex tasks and will take longer than a human for simpler tasks.
57

6-
The 'code' command for AICodeBot is designed to automate coding
8+
Play with it, but don't expect too much. Do you feel like [contributing](../CONTRIBUTING.md)? 😃
9+
10+
We'll document it here anyway, so you can see where we're going with it, ala
11+
[README driven development](https://tom.preston-werner.com/2010/08/23/readme-driven-development.html)
12+
13+
The `sidekick` command for AICodeBot is designed to automate coding
714
tasks based on instructions from you. This feature aims to boost developer
815
productivity by handling various aspects of the coding process, but keeping you
916
in charge of the process and commiting the code.
@@ -13,7 +20,7 @@ code bases one git commit at a time.
1320

1421
## Feature Overview
1522

16-
`aicodebot code` has several steps:
23+
`aicodebot sidekick` works as an agent with several steps:
1724

1825
1. **Task Understanding**: AICodeBot interprets the coding task by prompting you
1926
for requirements.
@@ -58,25 +65,21 @@ test results.
5865

5966
These are example prompts that you can use to guide AICodeBot in performing various coding tasks, ranging from practical code improvements to fun and whimsical modifications.
6067

61-
1. "Identify areas in the code where additional logging would be beneficial."
62-
1. "Find places that make API calls and add a link to the documentation for the API."
63-
1. "Replace all instances of the variable name 'foo' with 'bar'."
68+
1. "Add thorough and helpful logging"
69+
1. "Find places that make API calls and add a link to the documentation for the API endpoint."
6470
1. "Find all instances of the word 'bug' in the comments and replace them with 'feature'."
65-
1. "Identify areas in the code where more descriptive variable names could be used."
71+
1. "Update the README.md file to include a link to the project's documentation."
72+
1. "Replace the non descript variable names with more descriptive names and make sure the tests pass when you are done"
6673
1. "Identify potential performance improvements in the code."
67-
1. "Scan the codebase for potential security vulnerabilities."
68-
1. "Identify areas where comments could be added for better understanding."
69-
1. "Find sections of code that lack comments and add appropriate comments."
70-
1. "Identify sections of code that could be refactored for better readability or efficiency."
74+
1. "Scan the code for potential security vulnerabilities."
75+
1. "Find sections of code that lack comments and add appropriate, helpful comments."
7176
1. "Find complex sections of code and suggest ways to simplify them."
7277
1. "Check codecov.io for code coverage and suggest areas where additional tests could be added."
73-
1. "Find and remove any dead or unused code."
74-
1. "Review the project's documentation and suggest improvements."
75-
1. "Look at Honeybadger.io for error reports and suggest improvements."
76-
1. "Find all the sad comments in the code and add a happy emoji next to them."
77-
1. "Find areas in the code that could be made more efficient by using a different data structure."
78+
1. "Review the project's documentation and tell me what's undocumented."
79+
1. "Look at Honeybadger.io for error reports and fix bugs that you can, suggest pointers for the ones that you can't"
7880
1. "Identify areas where the use of a library or framework could simplify the code."
79-
1. "Review the codebase and suggest improvements based on best practices for Python 3.11"
80-
1. "Find instances where concurrency or parallelism could be used for efficiency."
81+
1. "Review the codebase and suggest improvements based on best practices for the latest version of Python, Javascript, etc. Update the code to use the latest best practices."
8182
1. "Identify areas where error handling could be improved."
8283
1. "Find areas where the code could be made more robust against failure."
84+
1. "Find and remove any dead or unused code."
85+
1. "Emojis. Emojis everywhere."

0 commit comments

Comments
 (0)