claude-teammate 0.1.26 → 0.1.28
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 +20 -25
- package/package.json +1 -1
- package/src/claude.js +1 -1
package/README.md
CHANGED
|
@@ -17,12 +17,16 @@
|
|
|
17
17
|
<a href="https://github.com/ignify-rd/claude-teammate/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT License" /></a>
|
|
18
18
|
</p>
|
|
19
19
|
|
|
20
|
-
|
|
20
|
+
<h1 align="center">An autonomous software engineer<br />that lives in your Jira and GitHub</h1>
|
|
21
21
|
|
|
22
22
|
Claude Teammate is an AI bot that works around the clock - picking up tickets, writing plans, opening PRs, acting on feedback, and reviewing code. No stand-ups. No Slack pings. No passive-aggressive "per my last email." Just like your best teammate, minus the coffee breath.
|
|
23
23
|
|
|
24
24
|
Assign it tickets. It ships.
|
|
25
25
|
|
|
26
|
+
<p align="center">
|
|
27
|
+
<img src="assets/demo.gif" alt="Demo" width="640" style="border: 1px solid #d1d5db;" />
|
|
28
|
+
</p>
|
|
29
|
+
|
|
26
30
|
| | Step | What happens |
|
|
27
31
|
| ------ | ------------------ | ----------------------------------------------------------------------------------------------------- |
|
|
28
32
|
| **01** | Assign the ticket | Assign the Jira ticket to the bot. |
|
|
@@ -30,8 +34,6 @@ Assign it tickets. It ships.
|
|
|
30
34
|
| **03** | It ships | Opens a PR. Responds to feedback. Keeps going until it's merged. |
|
|
31
35
|
| **04** | It remembers | Retains build commands, known pitfalls, and lessons from every task it has shipped - so the next ticket in the same epic starts smarter. |
|
|
32
36
|
|
|
33
|
-

|
|
34
|
-
|
|
35
37
|
<br/>
|
|
36
38
|
|
|
37
39
|
## Claude Teammate is right for you if
|
|
@@ -104,7 +106,15 @@ tm8 start
|
|
|
104
106
|
|
|
105
107
|
`start` creates `~/.tm8/.env` on the first run. If that config already exists with the required values, setup is skipped and your credentials are not prompted for again.
|
|
106
108
|
|
|
107
|
-
|
|
109
|
+
```env
|
|
110
|
+
# .env file generated by `tm8 start`
|
|
111
|
+
JIRA_BASE_URL=https://yourorg.atlassian.net
|
|
112
|
+
JIRA_BOT_EMAIL=bot@yourorg.com
|
|
113
|
+
JIRA_BOT_API_TOKEN=...
|
|
114
|
+
GITHUB_PAT=ghp_...
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
To run multiple agents on the same machine, use `--local` to store agent status and memory in the current working directory.
|
|
108
118
|
|
|
109
119
|
To upgrade to latest version
|
|
110
120
|
|
|
@@ -119,7 +129,7 @@ tm8 status
|
|
|
119
129
|
tm8 stop
|
|
120
130
|
```
|
|
121
131
|
|
|
122
|
-
|
|
132
|
+
Runtime files and memory are stored in:
|
|
123
133
|
|
|
124
134
|
```text
|
|
125
135
|
~/.tm8/
|
|
@@ -136,20 +146,6 @@ Global runtime files and memory are stored in:
|
|
|
136
146
|
└── issue-{jira-key}.md
|
|
137
147
|
```
|
|
138
148
|
|
|
139
|
-
With `--local`, the same `.claude-teammate/` and `memory/` folders are created in the current working directory instead.
|
|
140
|
-
|
|
141
|
-
`epic-{jira-key}.md` stores shared epic facts such as canonical epic identity, related repositories, reusable summaries, and guardrails. `issue-{jira-key}.md` stores issue-specific workflow state, clarification history, and GitHub issue tracking.
|
|
142
|
-
|
|
143
|
-
The worker polls Jira once per minute. It transitions `To Do` issues to `In Progress`, asks for repo URLs when epic memory lacks them, clones all referenced repos into `.claude-teammate/repos/`, uses Claude CLI to clarify requirements from Jira comments across those repos, and creates GitHub issues once the requirements are clear enough.
|
|
144
|
-
|
|
145
|
-
```env
|
|
146
|
-
# .env file generated by `tm8 start` or `tm8 start --local`
|
|
147
|
-
JIRA_BASE_URL=https://yourorg.atlassian.net
|
|
148
|
-
JIRA_BOT_EMAIL=bot@yourorg.com
|
|
149
|
-
JIRA_BOT_API_TOKEN=...
|
|
150
|
-
GITHUB_PAT=ghp_...
|
|
151
|
-
```
|
|
152
|
-
|
|
153
149
|
<br/>
|
|
154
150
|
|
|
155
151
|
## FAQ
|
|
@@ -166,18 +162,17 @@ Yes. Each epic is scoped to its own Jira domain and workspace, and can map to on
|
|
|
166
162
|
**Does it understand the codebase or just generate generic code?**
|
|
167
163
|
It reads the actual repository before writing anything - structure, conventions, existing patterns. The plan it proposes is specific to your code, not a template.
|
|
168
164
|
|
|
165
|
+
**Can I use Claude skills or MCP, and does it respect `CLAUDE.md`?**
|
|
166
|
+
Yes. Claude skills, configured MCP servers, and repo instructions in `CLAUDE.md` are available and respected just like they are in a normal Claude-driven workflow. Playwright MCP is built in and enabled by default so challenging frontend tasks can be verified in-browser.
|
|
167
|
+
|
|
169
168
|
<br/>
|
|
170
169
|
|
|
171
170
|
## Roadmap
|
|
172
171
|
|
|
172
|
+
- Ensure no conflicts for multiple concurrent claude-teammate agents
|
|
173
173
|
- GitLab support
|
|
174
174
|
- Bitbucket support
|
|
175
|
-
-
|
|
176
|
-
- Slack and Teams notifications when PRs are opened or merged
|
|
177
|
-
- Automatic PR description generation from commit history and issue context
|
|
178
|
-
- Branch-naming convention enforcement per epic or project config
|
|
179
|
-
- Stale-issue nudges when tickets sit unactioned past a configurable threshold
|
|
180
|
-
- Test-coverage gating before issue closure
|
|
175
|
+
- Slack and Teams integration
|
|
181
176
|
|
|
182
177
|
<br/>
|
|
183
178
|
|
package/package.json
CHANGED
package/src/claude.js
CHANGED
|
@@ -1074,7 +1074,7 @@ Instructions:
|
|
|
1074
1074
|
- Implement the plan described in the pull request body.
|
|
1075
1075
|
- Smart quotes and em/en dashes are not allowed. Use: smart quotes -> ", em/en dashes -> -.
|
|
1076
1076
|
- If the latest human PR comment requests a change or reports a problem, address that feedback as part of this implementation run.
|
|
1077
|
-
- If this involves frontend
|
|
1077
|
+
- If this involves challenging frontend fixes/implementations, infer how to start the app from the repository code, launch it locally, and verify the implementation with Playwright MCP.
|
|
1078
1078
|
- Do not commit or push; leave modified files in the working tree.
|
|
1079
1079
|
- Return summary as 1-2 sentences suitable to post directly as a PR comment.
|
|
1080
1080
|
- Return epic_facts and epic_guardrails only for reusable non-obvious repo or epic knowledge. Use epic_facts for durable factual notes such as build commands or stable repo behavior. Leave them empty when there is nothing worth remembering.
|