Skip to content

Commit 4a7e82e

Browse files
marmutappmarmutapp
committed
Public snapshot: 2026-07-21
1 parent 48b1147 commit 4a7e82e

174 files changed

Lines changed: 1760 additions & 253 deletions

File tree

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/adapter_request.yml‎

Lines changed: 65 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,65 @@
1+
name: Adapter request
2+
description: Request support for a new AI coding tool.
3+
title: "[Adapter]: "
4+
labels: ["enhancement"]
5+
body:
6+
- type: markdown
7+
attributes:
8+
value: |
9+
Observer supports 26 AI coding tools today via per-tool
10+
adapters. If yours isn't one of them, this form helps us
11+
(or you!) scope a new adapter. See CONTRIBUTING.md if you'd
12+
like to build it yourself — adapter contributions are
13+
especially welcome.
14+
- type: input
15+
id: tool-name
16+
attributes:
17+
label: Tool name + vendor
18+
placeholder: e.g. "Foo CLI" by Foo Inc.
19+
validations:
20+
required: true
21+
- type: input
22+
id: log-location
23+
attributes:
24+
label: Where does it store session logs?
25+
description: A file path or directory, if you know it (e.g. ~/.foo/sessions/). Leave blank if unknown.
26+
- type: dropdown
27+
id: has-tokens
28+
attributes:
29+
label: Do the local logs contain token counts?
30+
options:
31+
- "Yes"
32+
- "No"
33+
- Not sure
34+
validations:
35+
required: true
36+
- type: input
37+
id: docs-link
38+
attributes:
39+
label: Link(s) to the tool's own docs
40+
- type: dropdown
41+
id: fixtures
42+
attributes:
43+
label: Would you be willing to share sanitized session-log fixtures?
44+
description: Anonymized, secret-free samples make building and testing an adapter much faster.
45+
options:
46+
- "Yes"
47+
- "No"
48+
- Maybe, ask me
49+
validations:
50+
required: true
51+
- type: dropdown
52+
id: test-branch
53+
attributes:
54+
label: Would you be willing to test a branch against your real setup?
55+
options:
56+
- "Yes"
57+
- "No"
58+
- Maybe, ask me
59+
validations:
60+
required: true
61+
- type: textarea
62+
id: notes
63+
attributes:
64+
label: Anything else worth knowing?
65+
description: Quirks, known limitations, how the tool is typically installed/run.

‎.github/ISSUE_TEMPLATE/bug_report.yml‎

Lines changed: 80 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,80 @@
1+
name: Bug report
2+
description: Something isn't working the way it should.
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. Before filing,
10+
please check open issues and Discussions for an existing
11+
report.
12+
13+
If this is a security vulnerability, please stop and use
14+
private reporting instead (see SECURITY.md) — don't file it
15+
here.
16+
- type: input
17+
id: version
18+
attributes:
19+
label: Observer version
20+
description: Output of `observer --version`
21+
placeholder: v1.22.0
22+
validations:
23+
required: true
24+
- type: dropdown
25+
id: install-channel
26+
attributes:
27+
label: Install channel
28+
options:
29+
- npm
30+
- PyPI
31+
- VS Code extension
32+
- Release binary (GitHub Releases)
33+
- Built from source
34+
validations:
35+
required: true
36+
- type: dropdown
37+
id: os
38+
attributes:
39+
label: Operating system
40+
options:
41+
- Linux
42+
- macOS
43+
- Windows
44+
- WSL
45+
validations:
46+
required: true
47+
- type: input
48+
id: ai-tool
49+
attributes:
50+
label: Affected AI tool + version
51+
description: e.g. Claude Code 1.x, Codex CLI 0.130, Cursor 3.x — leave blank if not tool-specific.
52+
- type: textarea
53+
id: expected
54+
attributes:
55+
label: What did you expect to happen?
56+
validations:
57+
required: true
58+
- type: textarea
59+
id: actual
60+
attributes:
61+
label: What actually happened?
62+
validations:
63+
required: true
64+
- type: textarea
65+
id: repro
66+
attributes:
67+
label: Steps to reproduce
68+
description: As specific as you can — commands run, config used, order of operations.
69+
validations:
70+
required: true
71+
- type: textarea
72+
id: logs
73+
attributes:
74+
label: Relevant logs or output
75+
description: >
76+
Observer scrubs known secret patterns from what it captures, but
77+
that's best-effort — please review pasted output yourself for
78+
API keys, tokens, or local file paths you don't want public
79+
before submitting.
80+
render: shell

‎.github/ISSUE_TEMPLATE/config.yml‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
blank_issues_enabled: true
2+
contact_links:
3+
- name: Ask a question / share an idea
4+
url: https://github.com/marmutapp/superbased-observer/discussions
5+
about: For questions, ideas, and general discussion — not for bug reports.
6+
- name: Report a security vulnerability
7+
url: https://github.com/marmutapp/superbased-observer/security/advisories/new
8+
about: Please report vulnerabilities privately, not as a public issue. See SECURITY.md.

‎.github/ISSUE_TEMPLATE/cost_discrepancy.yml‎

Lines changed: 75 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,75 @@
1+
name: Cost / token discrepancy
2+
description: Observer's reported cost or token counts don't match what you expected.
3+
title: "[Cost]: "
4+
labels: ["bug"]
5+
body:
6+
- type: markdown
7+
attributes:
8+
value: |
9+
Cost accuracy is core to what Observer does — the more detail
10+
on the actual numbers, the faster we can find the gap.
11+
- type: input
12+
id: version
13+
attributes:
14+
label: Observer version
15+
placeholder: v1.22.0
16+
validations:
17+
required: true
18+
- type: input
19+
id: ai-tool
20+
attributes:
21+
label: Affected AI tool + version
22+
placeholder: e.g. Claude Code 1.x, Codex CLI 0.130
23+
validations:
24+
required: true
25+
- type: input
26+
id: provider-model
27+
attributes:
28+
label: Provider + model
29+
placeholder: e.g. Anthropic, claude-sonnet-4-5
30+
validations:
31+
required: true
32+
- type: dropdown
33+
id: capture-mode
34+
attributes:
35+
label: Capture mode
36+
description: Was the session routed through Observer's API proxy, or captured from logs/hooks only?
37+
options:
38+
- Proxy-routed
39+
- Logs + hooks only
40+
- Not sure
41+
validations:
42+
required: true
43+
- type: textarea
44+
id: observed
45+
attributes:
46+
label: What Observer reported
47+
description: Token counts and/or dollar cost, as shown in the dashboard/CLI.
48+
validations:
49+
required: true
50+
- type: textarea
51+
id: expected
52+
attributes:
53+
label: What you expected
54+
description: The numbers you believe are correct, and why.
55+
validations:
56+
required: true
57+
- type: dropdown
58+
id: expected-source
59+
attributes:
60+
label: Where did the "expected" numbers come from?
61+
options:
62+
- Provider's own console/dashboard
63+
- Provider's invoice/billing page
64+
- Another Observer view (dashboard vs CLI vs MCP disagree)
65+
- Manual calculation
66+
- Not sure
67+
validations:
68+
required: true
69+
- type: textarea
70+
id: logs
71+
attributes:
72+
label: Relevant session ID, logs, or screenshots
73+
description: >
74+
Please review for secrets or paths before pasting — scrubbing
75+
is best-effort.

‎.github/ISSUE_TEMPLATE/feature_proposal.yml‎

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
name: Feature proposal
2+
description: Propose a new feature or an improvement to an existing one.
3+
title: "[Feature]: "
4+
labels: ["enhancement"]
5+
body:
6+
- type: markdown
7+
attributes:
8+
value: |
9+
For anything larger than a small fix, a quick Discussion
10+
first can save you a rewrite — but this form works too if
11+
you'd rather start here.
12+
- type: textarea
13+
id: problem
14+
attributes:
15+
label: What problem does this solve?
16+
description: What are you trying to do today that Observer doesn't support well?
17+
validations:
18+
required: true
19+
- type: textarea
20+
id: proposal
21+
attributes:
22+
label: Proposed solution
23+
description: What would you like to see? Sketch the CLI/dashboard/config surface if relevant.
24+
validations:
25+
required: true
26+
- type: textarea
27+
id: alternatives
28+
attributes:
29+
label: Alternatives considered
30+
description: Other ways to solve this, including workarounds you're using today.
31+
- type: dropdown
32+
id: willing
33+
attributes:
34+
label: Would you be willing to submit a PR for this?
35+
options:
36+
- "Yes"
37+
- "No"
38+
- Maybe, with some guidance
39+
validations:
40+
required: true
41+
- type: textarea
42+
id: context
43+
attributes:
44+
label: Additional context
45+
description: Anything else — links, related issues, screenshots.

‎.github/ISSUE_TEMPLATE/installation_problem.yml‎

Lines changed: 75 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,75 @@
1+
name: Installation problem
2+
description: Observer won't install, won't start, or fails on first run.
3+
title: "[Install]: "
4+
labels: ["bug"]
5+
body:
6+
- type: markdown
7+
attributes:
8+
value: |
9+
For install and first-run problems — package manager errors,
10+
binary won't launch, `observer init`/`observer start` failing,
11+
permission errors, etc.
12+
- type: input
13+
id: version
14+
attributes:
15+
label: Observer version (or version you tried to install)
16+
placeholder: v1.22.0
17+
validations:
18+
required: true
19+
- type: dropdown
20+
id: install-channel
21+
attributes:
22+
label: Install channel
23+
options:
24+
- npm
25+
- PyPI
26+
- VS Code extension
27+
- Release binary (GitHub Releases)
28+
- Built from source
29+
validations:
30+
required: true
31+
- type: dropdown
32+
id: os
33+
attributes:
34+
label: Operating system
35+
options:
36+
- Linux
37+
- macOS
38+
- Windows
39+
- WSL
40+
validations:
41+
required: true
42+
- type: input
43+
id: os-details
44+
attributes:
45+
label: OS version / distro / architecture
46+
placeholder: e.g. Ubuntu 24.04 on WSL2, macOS 15 arm64, Windows 11 x64
47+
- type: textarea
48+
id: command
49+
attributes:
50+
label: Exact command(s) you ran
51+
render: shell
52+
validations:
53+
required: true
54+
- type: textarea
55+
id: expected
56+
attributes:
57+
label: What did you expect to happen?
58+
validations:
59+
required: true
60+
- type: textarea
61+
id: actual
62+
attributes:
63+
label: What actually happened?
64+
validations:
65+
required: true
66+
- type: textarea
67+
id: logs
68+
attributes:
69+
label: Full error output
70+
description: >
71+
Please review this for secrets or local paths before pasting —
72+
Observer's scrubbing doesn't apply to raw install-tool output.
73+
render: shell
74+
validations:
75+
required: true

‎.github/PULL_REQUEST_TEMPLATE.md‎

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
## Summary
2+
3+
<!-- What does this PR do, and why? A sentence or two is fine. -->
4+
5+
## Linked issue
6+
7+
<!-- Closes #123 — or "N/A" if this wasn't filed as an issue first. -->
8+
9+
## How was this tested?
10+
11+
<!-- Check what applies, and add any manual steps you ran. -->
12+
13+
- [ ] `make test` (go test -race ./...)
14+
- [ ] `make lint` (golangci-lint)
15+
- [ ] Manual testing — describe below:
16+
17+
## Docs impact
18+
19+
<!-- Does this change require a README, CHANGELOG, or other doc update?
20+
If you updated one, note it here. If none is needed, say so. -->
21+
22+
## Checklist
23+
24+
- [ ] Commit title(s) follow conventional commits (`feat:`, `fix:`,
25+
`docs:`, `test:`, `chore:`, `refactor:`, `perf:`)
26+
- [ ] Tests added or updated for the behavior this PR changes
27+
- [ ] `make lint` is clean
28+
- [ ] No secrets, API keys, or private local paths in the diff or in
29+
any test fixtures

0 commit comments

Comments
 (0)