Skip to content
Open

docs #12470

Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -127,6 +127,22 @@ new SHA in the superproject as one reviewable commit.
remind you a teammate's pin bump left a module behind β€” run `make baseline` after
pulling the superproject to align.

## Branch naming

Linear is connected to GitHub (`mindsdb` org). Every branch must include a Linear issue ID so the PR is automatically linked to the ticket.

**Format:** `<issue-id>-<short-description>` β€” copy it directly from the issue in Linear (branch icon on any issue card).

```
eng-123-fix-sso-no-credits
eng-456-add-attachment-thumbnails
```

- The team prefix is **`ENG`** (lowercase in branch names: `eng-`)
- Linear generates the full branch name for you β€” always use that, don't invent one
- PRs opened from a correctly named branch auto-attach to the Linear issue; no manual linking needed
- Hotfixes that don't have a ticket yet: create the ticket first, then branch from it

## Running locally (web browser mode)

After initializing submodules, start the full stack with:
Expand Down
2 changes: 1 addition & 1 deletion backend/core_agent
Submodule core_agent updated 69 files
+34 βˆ’33 .github/workflows/release.yml
+2 βˆ’2 .github/workflows/tests.yml
+71 βˆ’55 README.md
+25 βˆ’27 anton/README.md
+1 βˆ’1 anton/__init__.py
+36 βˆ’0 anton/analytics.py
+1 βˆ’0 anton/chat.py
+1 βˆ’0 anton/chat_session.py
+8 βˆ’18 anton/commands/skills.py
+39 βˆ’3 anton/config/settings.py
+4 βˆ’3 anton/core/artifacts/models.py
+53 βˆ’8 anton/core/artifacts/store.py
+11 βˆ’1 anton/core/backends/local.py
+10 βˆ’7 anton/core/backends/scratchpad_boot.py
+20 βˆ’4 anton/core/backends/utils.py
+105 βˆ’0 anton/core/datasources/datasources.md
+6 βˆ’0 anton/core/dispatch/local_runtime.py
+15 βˆ’0 anton/core/interaction/__init__.py
+53 βˆ’0 anton/core/interaction/cli.py
+76 βˆ’0 anton/core/interaction/selection.py
+16 βˆ’3 anton/core/llm/anthropic.py
+29 βˆ’6 anton/core/llm/client.py
+47 βˆ’8 anton/core/llm/openai.py
+27 βˆ’5 anton/core/llm/prompt_builder.py
+73 βˆ’12 anton/core/llm/prompts.py
+10 βˆ’2 anton/core/llm/provider.py
+8 βˆ’0 anton/core/llm/tracing.py
+17 βˆ’10 anton/core/memory/acc.py
+240 βˆ’162 anton/core/memory/skills.py
+1 βˆ’0 anton/core/runtime.py
+183 βˆ’38 anton/core/session.py
+2 βˆ’0 anton/core/settings.py
+2 βˆ’2 anton/core/tools/recall_skill.py
+210 βˆ’0 anton/core/tools/skill_format.py
+73 βˆ’0 anton/core/tools/tool_defs.py
+242 βˆ’41 anton/core/tools/tool_handlers.py
+93 βˆ’1 anton/core/tools/web_tools.py
+102 βˆ’2 anton/core/utils/scratchpad.py
+87 βˆ’16 anton/publisher.py
+96 βˆ’11 anton/utils/datasources.py
+1 βˆ’1 docs/docs/developer/architecture.md
+3 βˆ’4 docs/docs/developer/brain-mapping.md
+13 βˆ’15 docs/docs/developer/skills-internals.md
+2 βˆ’2 docs/docs/start/install.md
+2 βˆ’2 docs/docs/use/desktop.md
+3 βˆ’3 pyproject.toml
+9 βˆ’3 tests/e2e/scenarios/test_loop_safety.py
+6 βˆ’2 tests/test_acc.py
+105 βˆ’0 tests/test_analytics.py
+56 βˆ’0 tests/test_artifacts.py
+1 βˆ’1 tests/test_chat_context.py
+23 βˆ’0 tests/test_client.py
+84 βˆ’0 tests/test_datasource_context_identity.py
+32 βˆ’0 tests/test_dispatch_error_message.py
+10 βˆ’11 tests/test_prompt_builder_skills.py
+46 βˆ’1 tests/test_provider.py
+103 βˆ’0 tests/test_publish_access.py
+7 βˆ’10 tests/test_recall_skill.py
+45 βˆ’0 tests/test_resilience_nudge.py
+32 βˆ’7 tests/test_scratchpad.py
+132 βˆ’0 tests/test_scratchpad_observer_dispatch.py
+39 βˆ’0 tests/test_scrubbing.py
+4 βˆ’3 tests/test_session_skills_init.py
+53 βˆ’0 tests/test_settings.py
+12 βˆ’22 tests/test_skill_commands.py
+14 βˆ’20 tests/test_skills_e2e.py
+63 βˆ’76 tests/test_skills_store.py
+65 βˆ’0 tests/test_trace_headers.py
+1 βˆ’1 uv.lock
2 changes: 1 addition & 1 deletion backend/core_api
Submodule core_api updated 138 files
83 changes: 60 additions & 23 deletions docs/use-cases.html
Original file line number Diff line number Diff line change
Expand Up @@ -241,18 +241,18 @@

<div class="hero-wrap">
<div class="eyebrow">Use Cases</div>
<h1>Two things.<br><em>Automate</em> and <em>Create.</em></h1>
<h1>Two things.<br><em>Create</em> and <em>Automate.</em></h1>
<p class="lede">
Minds Cowork is built around two core primitives. Everything below is an expression of one or both.
</p>
<div class="primitives">
<div class="primitive">
<div class="p-label"><span>Automate</span></div>
<div class="p-desc">Recurring tasks that run without you β€” reports, monitoring, workflows, digests.</div>
<div class="p-label"><span>Create</span></div>
<div class="p-desc">Documents, apps, and workflow tools built around how you actually work β€” yours to publish, share, and keep.</div>
</div>
<div class="primitive">
<div class="p-label"><span>Create</span></div>
<div class="p-desc">Artifacts that used to take hours β€” apps, decks, docs, analyses, dashboards.</div>
<div class="p-label"><span>Automate</span></div>
<div class="p-desc">Recurring tasks that run without you β€” reports, monitoring, workflows, and scheduled operations.</div>
</div>
</div>
</div>
Expand All @@ -269,6 +269,21 @@ <h2>Creators</h2>
</div>
</div>
<div class="use-case-grid">
<div class="uc-card">
<span class="uc-tag">Create</span>
<div class="uc-title">Personal knowledge base</div>
<div class="uc-desc">Upload your notes, docs, and bookmarks. Ask questions in plain language and get answers that actually reference your material.</div>
</div>
<div class="uc-card">
<span class="uc-tag">Create</span>
<div class="uc-title">Your brand playbook, always current</div>
<div class="uc-desc">Connect your tone guidelines, past work, and campaign feedback. The agent synthesizes a living brand doc your whole team references β€” and updates it as you evolve.</div>
</div>
<div class="uc-card">
<span class="uc-tag">Create</span>
<div class="uc-title">A content ops app, built your way</div>
<div class="uc-desc">Pitches, drafts, deadlines, and briefs in one tool β€” laid out exactly the way your team works, not a generic template someone else designed for someone else.</div>
</div>
<div class="uc-card">
<span class="uc-tag">Automate</span>
<div class="uc-title">Content pipeline on autopilot</div>
Expand All @@ -281,11 +296,6 @@ <h2>Creators</h2>
<div class="uc-desc">Feed a transcript or essay and get a Twitter thread, LinkedIn post, and email summary β€” automatically.</div>
<div class="uc-flow">video β†’ clips β†’ captions β†’ posts</div>
</div>
<div class="uc-card">
<span class="uc-tag">Create</span>
<div class="uc-title">Personal knowledge base</div>
<div class="uc-desc">Upload your notes, docs, and bookmarks. Ask questions in plain language and get answers that actually reference your material.</div>
</div>
</div>
</div>

Expand All @@ -299,6 +309,17 @@ <h2>Operators</h2>
</div>
</div>
<div class="use-case-grid">
<div class="uc-card">
<span class="uc-tag">Create</span>
<div class="uc-title">An ops dashboard wired to your data</div>
<div class="uc-desc">A live view of your team's KPIs, queues, and blockers β€” connected to your actual data sources, laid out the way you think about the work. Publish it to a URL in minutes.</div>
<div class="uc-flow">data β†’ dashboard β†’ publish β†’ always live</div>
</div>
<div class="uc-card">
<span class="uc-tag">Create</span>
<div class="uc-title">Codify your process as a tool</div>
<div class="uc-desc">That SOP buried in a Notion doc or a teammate's head β€” turn it into a working app anyone on the team can use. Step-by-step, context-aware, no engineering required.</div>
</div>
<div class="uc-card">
<span class="uc-tag">Automate</span>
<div class="uc-title">Live data reports, written for you</div>
Expand Down Expand Up @@ -334,18 +355,23 @@ <h2>Strategists</h2>
<div class="uc-title">Ask across all your data</div>
<div class="uc-desc">Query across docs, tickets, spreadsheets, and databases in plain language. No SQL, no dashboards.</div>
</div>
<div class="uc-card">
<span class="uc-tag">Automate</span>
<div class="uc-title">Competitive research digest</div>
<div class="uc-desc">Run a competitor sweep on a schedule. Every week you get a structured digest of what changed β€” pricing, features, messaging.</div>
<div class="uc-flow">sources β†’ extract β†’ compare β†’ report</div>
</div>
<div class="uc-card">
<span class="uc-tag">Create</span>
<div class="uc-title">Synthesize feedback at scale</div>
<div class="uc-desc">Feed support tickets, reviews, and survey responses. Get back themes, sentiment, and concrete product signal.</div>
<div class="uc-flow">feedback β†’ themes β†’ insights β†’ action</div>
</div>
<div class="uc-card">
<span class="uc-tag">Create</span>
<div class="uc-title">Turn analysis into a shareable app</div>
<div class="uc-desc">Package a market analysis or research project into a live document teammates can query in plain language β€” no re-presenting the same deck every quarter.</div>
</div>
<div class="uc-card">
<span class="uc-tag">Automate</span>
<div class="uc-title">Competitive research digest</div>
<div class="uc-desc">Run a competitor sweep on a schedule. Every week you get a structured digest of what changed β€” pricing, features, messaging.</div>
<div class="uc-flow">sources β†’ extract β†’ compare β†’ report</div>
</div>
</div>
</div>

Expand All @@ -354,20 +380,31 @@ <h2>Strategists</h2>
<div class="persona-header">
<div class="persona-icon">β—‡</div>
<div>
<h2>For everyone</h2>
<div class="persona-sub">Any knowledge worker with repetitive work</div>
<h2>For every team</h2>
<div class="persona-sub">Anything you build is uniquely yours</div>
</div>
</div>
<div class="use-case-grid">
<div class="uc-card">
<span class="uc-tag">Automate</span>
<div class="uc-title">Automate any multi-step task</div>
<div class="uc-desc">If it involves reading something and writing something else on a schedule, the agent can own it.</div>
<span class="uc-tag">Create</span>
<div class="uc-title">Documents from your actual data</div>
<div class="uc-desc">Proposals, playbooks, briefs, investor updates β€” written by the agent, sourced from your connected data, published in minutes. Not a template. Your content.</div>
</div>
<div class="uc-card">
<span class="uc-tag">Create</span>
<div class="uc-title">Build internal AI tools</div>
<div class="uc-desc">Describe what your team needs. The agent builds it β€” a web app, a form, a dashboard β€” and deploys it, no engineering required.</div>
<div class="uc-title">Apps built for how you actually work</div>
<div class="uc-desc">A deal scorecard. A support triage tool. An onboarding portal. Describe it, and the agent builds and deploys it β€” no engineering required, live URL included.</div>
<div class="uc-flow">describe β†’ build β†’ publish β†’ share</div>
</div>
<div class="uc-card">
<span class="uc-tag">Create</span>
<div class="uc-title">Encode your secret sauce</div>
<div class="uc-desc">Every team has logic no off-the-shelf tool captures: a scoring rubric, a workflow step nobody else does, a way of reading the data that took years to develop. That uniqueness becomes a live tool β€” yours, not a template everyone else runs too.</div>
</div>
<div class="uc-card">
<span class="uc-tag">Automate</span>
<div class="uc-title">Own any multi-step recurring task</div>
<div class="uc-desc">If it involves reading something and writing something else on a schedule β€” a report, a digest, a status update β€” the agent can own it end to end.</div>
</div>
</div>
</div>
Expand Down
2 changes: 1 addition & 1 deletion frontend
Submodule frontend updated 132 files
Loading