Skip to content

Commit a0df976

Browse files
danielalbinssoncursoragent
danielalbinsson
and
cursoragent
committed
Initial open source release of agentic-kit.
Copy-paste React components for AI agent interaction patterns. Co-authored-by: Cursor <cursoragent@cursor.com>
0 parents  commit a0df976

43 files changed

Lines changed: 5894 additions & 0 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.github/ISSUE_TEMPLATE/bug_report.yml‎

Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
1+
name: Bug report
2+
description: Report a bug in a pattern demo or the site shell
3+
title: "[Bug]: "
4+
labels: ["bug"]
5+
body:
6+
- type: markdown
7+
attributes:
8+
value: |
9+
Thanks for taking the time to report a bug. Please include enough detail
10+
for us to reproduce the issue.
11+
12+
- type: textarea
13+
id: description
14+
attributes:
15+
label: What happened?
16+
description: A clear description of the bug.
17+
placeholder: The context panel does not trap focus when opened on mobile Safari.
18+
validations:
19+
required: true
20+
21+
- type: textarea
22+
id: steps
23+
attributes:
24+
label: Steps to reproduce
25+
description: Numbered steps to reproduce the behavior.
26+
placeholder: |
27+
1. Open agentic-kit.dev on iOS Safari
28+
2. Navigate to Context panel
29+
3. Open the panel
30+
validations:
31+
required: true
32+
33+
- type: textarea
34+
id: expected
35+
attributes:
36+
label: Expected behavior
37+
validations:
38+
required: true
39+
40+
- type: textarea
41+
id: actual
42+
attributes:
43+
label: Actual behavior
44+
validations:
45+
required: true
46+
47+
- type: input
48+
id: browser
49+
attributes:
50+
label: Browser / OS
51+
placeholder: Chrome 131 on macOS 15
52+
validations:
53+
required: true
54+
55+
- type: textarea
56+
id: screenshot
57+
attributes:
58+
label: Screenshots
59+
description: Drag and drop images here or paste a link.
60+
render: image

‎.github/ISSUE_TEMPLATE/feature_request.yml‎

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
name: Feature request
2+
description: Suggest a new agent UI pattern or improvement
3+
title: "[Feature]: "
4+
labels: ["enhancement"]
5+
body:
6+
- type: markdown
7+
attributes:
8+
value: |
9+
New patterns should align with the [agentic-ux.com](https://agentic-ux.com)
10+
spec catalog when possible.
11+
12+
- type: textarea
13+
id: problem
14+
attributes:
15+
label: Problem or use case
16+
description: What interaction problem does this solve for agent UIs?
17+
validations:
18+
required: true
19+
20+
- type: input
21+
id: spec
22+
attributes:
23+
label: Related agentic-ux spec (if any)
24+
placeholder: https://agentic-ux.com/...
25+
26+
- type: textarea
27+
id: solution
28+
attributes:
29+
label: Proposed solution
30+
description: How should the pattern behave? Include UX notes if helpful.
31+
validations:
32+
required: true
33+
34+
- type: textarea
35+
id: alternatives
36+
attributes:
37+
label: Alternatives considered
38+
description: Other approaches you've seen or considered.
39+
40+
- type: checkboxes
41+
id: scope
42+
attributes:
43+
label: Contribution
44+
options:
45+
- label: I am willing to open a pull request for this
46+
required: false

‎.github/pull_request_template.md‎

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
## Summary
2+
3+
<!-- What does this PR change and why? -->
4+
5+
## Related issue
6+
7+
<!-- Link issue: Fixes #123 -->
8+
9+
## Checklist
10+
11+
- [ ] `pnpm lint` passes locally
12+
- [ ] `pnpm build` passes locally
13+
- [ ] Screenshot or recording attached for visible UI changes
14+
- [ ] Accessibility checked (keyboard, focus, contrast, `prefers-reduced-motion`)
15+
- [ ] Copied snippet remains self-contained (no Tailwind in exported code)

‎.github/workflows/ci.yml‎

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
name: CI
2+
3+
on:
4+
push:
5+
branches: [main]
6+
pull_request:
7+
branches: [main]
8+
9+
jobs:
10+
lint-and-build:
11+
runs-on: ubuntu-latest
12+
steps:
13+
- uses: actions/checkout@v4
14+
15+
- uses: pnpm/action-setup@v4
16+
with:
17+
version: 9
18+
19+
- uses: actions/setup-node@v4
20+
with:
21+
node-version: 20
22+
cache: pnpm
23+
24+
- run: pnpm install --frozen-lockfile
25+
- run: pnpm lint
26+
- run: pnpm build

‎.gitignore‎

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
# Logs
2+
logs
3+
*.log
4+
npm-debug.log*
5+
yarn-debug.log*
6+
yarn-error.log*
7+
pnpm-debug.log*
8+
lerna-debug.log*
9+
10+
# Dependencies
11+
node_modules
12+
package-lock.json
13+
14+
# Build output
15+
dist
16+
dist-ssr
17+
*.local
18+
19+
# Environment & secrets
20+
.env
21+
.env.*
22+
!.env.example
23+
24+
# Build / cache
25+
.vite
26+
*.tsbuildinfo
27+
.turbo
28+
coverage
29+
30+
# OS & editors
31+
Thumbs.db
32+
*.swp
33+
.DS_Store
34+
.vscode/*
35+
!.vscode/extensions.json
36+
.idea
37+
*.suo
38+
*.ntvs*
39+
*.njsproj
40+
*.sln
41+
*.sw?
42+
43+
# Local agent / design tooling
44+
.cursor/*
45+
!.cursor/rules/
46+
.impeccable/

‎CODE_OF_CONDUCT.md‎

Lines changed: 132 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,132 @@
1+
# Contributor Covenant Code of Conduct
2+
3+
## Our Pledge
4+
5+
We as members, contributors, and leaders pledge to make participation in our
6+
community a harassment-free experience for everyone, regardless of age, body
7+
size, visible or invisible disability, ethnicity, sex characteristics, gender
8+
identity and expression, level of experience, education, socio-economic status,
9+
nationality, personal appearance, race, religion, or sexual identity
10+
and orientation.
11+
12+
We pledge to act and interact in ways that contribute to an open, welcoming,
13+
diverse, inclusive, and healthy community.
14+
15+
## Our Standards
16+
17+
Examples of behavior that contributes to a positive environment for our
18+
community include:
19+
20+
* Demonstrating empathy and kindness toward other people
21+
* Being respectful of differing opinions, viewpoints, and experiences
22+
* Giving and gracefully accepting constructive feedback
23+
* Accepting responsibility and apologizing to those affected by our mistakes,
24+
and learning from the experience
25+
* Focusing on what is best not just for us as individuals, but for the
26+
overall community
27+
28+
Examples of unacceptable behavior include:
29+
30+
* The use of sexualized language or imagery, and sexual attention or
31+
advances of any kind
32+
* Trolling, insulting or derogatory comments, and personal or political attacks
33+
* Public or private harassment
34+
* Publishing others' private information, such as a physical or email
35+
address, without their explicit permission
36+
* Other conduct which could reasonably be considered inappropriate in a
37+
professional setting
38+
39+
## Enforcement Responsibilities
40+
41+
Community leaders are responsible for clarifying and enforcing our standards of
42+
acceptable behavior and will take appropriate and fair corrective action in
43+
response to any behavior that they deem inappropriate, threatening, offensive,
44+
or harmful.
45+
46+
Community leaders have the right and responsibility to remove, edit, or reject
47+
comments, commits, code, wiki edits, issues, and other contributions that are
48+
not aligned to this Code of Conduct, and will communicate reasons for moderation
49+
decisions when appropriate.
50+
51+
## Scope
52+
53+
This Code of Conduct applies within all community spaces, and also applies when
54+
an individual is officially representing the community in public spaces.
55+
Examples of representing our community include using an official e-mail address,
56+
posting via an official social media account, or acting as an appointed
57+
representative at an online or offline event.
58+
59+
## Enforcement
60+
61+
Instances of abusive, harassing, or otherwise unacceptable behavior may be
62+
reported to the community leaders responsible for enforcement at
63+
daniel.albinsson@gmail.com.
64+
All complaints will be reviewed and investigated promptly and fairly.
65+
66+
All community leaders are obligated to respect the privacy and security of the
67+
reporter of any incident.
68+
69+
## Enforcement Guidelines
70+
71+
Community leaders will follow these Community Impact Guidelines in determining
72+
the consequences for any action they deem in violation of this Code of Conduct:
73+
74+
### 1. Correction
75+
76+
**Community Impact**: Use of inappropriate language or other behavior deemed
77+
unprofessional or unwelcome in the community.
78+
79+
**Consequence**: A private, written warning from community leaders, providing
80+
clarity around the nature of the violation and an explanation of why the
81+
behavior was inappropriate. A public apology may be requested.
82+
83+
### 2. Warning
84+
85+
**Community Impact**: A violation through a single incident or series
86+
of actions.
87+
88+
**Consequence**: A warning with consequences for continued behavior. No
89+
interaction with the people involved, including unsolicited interaction with
90+
those enforcing the Code of Conduct, for a specified period of time. This
91+
includes avoiding interactions in community spaces as well as external channels
92+
like social media. Violating these terms may lead to a temporary or
93+
permanent ban.
94+
95+
### 3. Temporary Ban
96+
97+
**Community Impact**: A serious violation of community standards, including
98+
sustained inappropriate behavior.
99+
100+
**Consequence**: A temporary ban from any sort of interaction or public
101+
communication with the community for a specified period of time. No public or
102+
private interaction with the people involved, including unsolicited interaction
103+
with those enforcing the Code of Conduct, is allowed during this period.
104+
Violating these terms may lead to a permanent ban.
105+
106+
### 4. Permanent Ban
107+
108+
**Community Impact**: Demonstrating a pattern of violation of community
109+
standards, including sustained inappropriate behavior, harassment of an
110+
individual, or aggression toward or disparagement of classes of individuals.
111+
112+
**Consequence**: A permanent ban from any sort of public interaction within
113+
the community.
114+
115+
## Attribution
116+
117+
This Code of Conduct is adapted from the [Contributor Covenant][homepage],
118+
version 2.1, available at
119+
[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
120+
121+
Community Impact Guidelines were inspired by
122+
[Mozilla's code of conduct enforcement ladder][Mozilla CoC].
123+
124+
For answers to common questions about this code of conduct, see the FAQ at
125+
[https://www.contributor-covenant.org/faq][FAQ]. Translations are available
126+
at [https://www.contributor-covenant.org/translations][translations].
127+
128+
[homepage]: https://www.contributor-covenant.org
129+
[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
130+
[Mozilla CoC]: https://github.com/mozilla/diversity
131+
[FAQ]: https://www.contributor-covenant.org/faq
132+
[translations]: https://www.contributor-covenant.org/translations

‎CONTRIBUTING.md‎

Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
# Contributing to agentic-kit
2+
3+
Thanks for helping improve the reference library for AI agent UI patterns. Contributions that match the [product intent](PRODUCT.md) and [design system](design.md) are especially welcome.
4+
5+
## What we're looking for
6+
7+
- New interaction patterns aligned with [agentic-ux.com](https://agentic-ux.com) specs
8+
- Fixes to pattern demos, accessibility, and copy-paste snippets
9+
- Documentation improvements
10+
- Site shell polish that stays true to the brand (see `design.md`)
11+
12+
## Development setup
13+
14+
Requires [Node.js](https://nodejs.org/) 20+ and [pnpm](https://pnpm.io/).
15+
16+
```bash
17+
pnpm install
18+
pnpm dev # start the dev server
19+
pnpm lint # eslint
20+
pnpm build # type-check + production build
21+
pnpm preview # preview the production build
22+
```
23+
24+
## Adding a pattern
25+
26+
1. Create `src/patterns/MyPattern.tsx` with a `*Demo` component and exported `*Code` string.
27+
2. Register the pattern in `src/lib/patterns.ts`.
28+
3. Keep the **copied snippet** self-contained — inline styles, no Tailwind in exported code.
29+
4. Respect `prefers-reduced-motion` with meaningful fallbacks.
30+
5. Link back to the relevant agentic-ux spec.
31+
32+
See the README for the full project structure.
33+
34+
## Pull request guidelines
35+
36+
- One pattern or focused change per PR.
37+
- Run `pnpm lint` and `pnpm build` before opening.
38+
- Include a screenshot or short screen recording for visible UI changes.
39+
- Note any accessibility considerations (keyboard, focus, contrast, reduced motion).
40+
41+
## Commit messages
42+
43+
Use short, imperative subject lines: `Add streaming caret pattern`, `Fix focus trap in context panel`.
44+
45+
## Code of conduct
46+
47+
This project follows the [Contributor Covenant](CODE_OF_CONDUCT.md). By participating, you agree to uphold it.

0 commit comments

Comments
 (0)