winter-super-cli 2026.6.20 → 2026.6.22

package/memories/readme.md

@@ -0,0 +1,35 @@
+# ❄️ Winter Memories
+
+This directory stores cross-project knowledge and learnings.
+
+## Memory Types
+
+### Long-term Memory
+Learned patterns, best practices, and project insights that persist across sessions.
+
+### Project Memory
+Project-specific knowledge including:
+- Project structure
+- Key files and their purposes
+- Common workflows
+- Team conventions
+
+## Commands
+
+- `/remember <text>` - Add a memory
+- `/memories` - Show all memories
+- `/memories search <query>` - Search memories
+- `/forget <pattern>` - Remove memories
+
+## Example Memories
+
+```
+- User prefers TypeScript over JavaScript
+- This project uses React with Vite
+- Database is PostgreSQL
+- API is REST-based
+```
+
+## Storage
+
+Memories are stored as JSON files in this directory, automatically organized by date and topic.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "winter-super-cli",
-  "version": "2026.6.20",
+  "version": "2026.6.22",
   "description": "❄️ AI-Powered Development CLI with Interactive REPL",
   "type": "module",
   "main": "bin/winter.js",
@@ -16,10 +16,15 @@
     "src/**/*.js",
     "!src/**/*.test.js",
     "resources/local/manifest.json",
+    "resources/local/agents.md/",
+    "resources/local/awesome-design-md/",
+    "resources/local/karpathy-tools/",
     "resources/local/page-agent/",
     "resources/local/ecc/",
     "!resources/local/ecc/node_modules/**",
     "!resources/local/ecc/package-lock.json",
+    "skills/",
+    "memories/",
     "README.md",
     "WINTER.md",
     "CHANGELOG.md",

package/resources/local/agents.md/AGENTS.md

@@ -0,0 +1,43 @@
+# AGENTS Guidelines for This Repository
+
+This repository contains a Next.js application located in the root of this repository. When
+working on the project interactively with an agent (e.g. the Codex CLI) please follow
+the guidelines below so that the development experience – in particular Hot Module
+Replacement (HMR) – continues to work smoothly.
+
+## 1. Use the Development Server, **not** `npm run build`
+
+* **Always use `npm run dev` (or `pnpm dev`, `yarn dev`, etc.)** while iterating on the
+  application.  This starts Next.js in development mode with hot-reload enabled.
+* **Do _not_ run `npm run build` inside the agent session.**  Running the production
+  build command switches the `.next` folder to production assets which disables hot
+  reload and can leave the development server in an inconsistent state.  If a
+  production build is required, do it outside of the interactive agent workflow.
+
+## 2. Keep Dependencies in Sync
+
+If you add or update dependencies remember to:
+
+1. Update the appropriate lockfile (`package-lock.json`, `pnpm-lock.yaml`, `yarn.lock`).
+2. Re-start the development server so that Next.js picks up the changes.
+
+## 3. Coding Conventions
+
+* Prefer TypeScript (`.tsx`/`.ts`) for new components and utilities.
+* Co-locate component-specific styles in the same folder as the component when
+  practical.
+
+## 4. Useful Commands Recap
+
+| Command            | Purpose                                            |
+| ------------------ | -------------------------------------------------- |
+| `npm run dev`      | Start the Next.js dev server with HMR.             |
+| `npm run lint`     | Run ESLint checks.                                 |
+| `npm run test`     | Execute the test suite (if present).               |
+| `npm run build`    | **Production build – _do not run during agent sessions_** |
+
+---
+
+Following these practices ensures that the agent-assisted development workflow stays
+fast and dependable.  When in doubt, restart the dev server rather than running the
+production build.

package/resources/local/agents.md/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 OpenAI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/resources/local/agents.md/README.md

@@ -0,0 +1,49 @@
+# AGENTS.md
+
+![AGENTS.md logo](./public/og.png)
+
+[AGENTS.md](https://agents.md) is a simple, open format for guiding coding agents.
+
+Think of AGENTS.md as a README for agents: a dedicated, predictable place
+to provide context and instructions to help AI coding agents work on your project.
+
+Below is a minimal example of an AGENTS.md file:
+
+```markdown
+# Sample AGENTS.md file
+
+## Dev environment tips
+- Use `pnpm dlx turbo run where <project_name>` to jump to a package instead of scanning with `ls`.
+- Run `pnpm install --filter <project_name>` to add the package to your workspace so Vite, ESLint, and TypeScript can see it.
+- Use `pnpm create vite@latest <project_name> -- --template react-ts` to spin up a new React + Vite package with TypeScript checks ready.
+- Check the name field inside each package's package.json to confirm the right name—skip the top-level one.
+
+## Testing instructions
+- Find the CI plan in the .github/workflows folder.
+- Run `pnpm turbo run test --filter <project_name>` to run every check defined for that package.
+- From the package root you can just call `pnpm test`. The commit should pass all tests before you merge.
+- To focus on one step, add the Vitest pattern: `pnpm vitest run -t "<test name>"`.
+- Fix any test or type errors until the whole suite is green.
+- After moving files or changing imports, run `pnpm lint --filter <project_name>` to be sure ESLint and TypeScript rules still pass.
+- Add or update tests for the code you change, even if nobody asked.
+
+## PR instructions
+- Title format: [<project_name>] <Title>
+- Always run `pnpm lint` and `pnpm test` before committing.
+```
+
+## Website
+
+This repository also includes a basic Next.js website hosted at https://agents.md/
+that explains the project’s goals in a simple way, and featuring some examples.
+
+### Running the app locally
+1. Install dependencies:
+   ```bash
+   pnpm install
+   ```
+2. Start the development server:
+   ```bash
+   pnpm run dev
+   ```
+3. Open your browser and go to http://localhost:3000

package/resources/local/agents.md/components/AboutSection.tsx

@@ -0,0 +1,37 @@
+import Section from "@/components/Section";
+
+const AboutSection = () => (
+  <Section title="About" className="pb-0" center maxWidthClass="max-w-3xl">
+    <p className="max-w-3xl">
+      AGENTS.md emerged from collaborative efforts across the AI software
+      development ecosystem, including{" "}
+      <a href="https://openai.com/codex/" className="underline hover:no-underline" target="_blank" rel="noopener noreferrer">OpenAI Codex</a>,{" "}
+      <a href="https://ampcode.com" className="underline hover:no-underline" target="_blank" rel="noopener noreferrer">Amp</a>,{" "}
+      <a href="https://jules.google" className="underline hover:no-underline" target="_blank" rel="noopener noreferrer">Jules from Google</a>,{" "}
+      <a href="https://cursor.com" className="underline hover:no-underline" target="_blank" rel="noopener noreferrer">Cursor</a>, and{" "}
+      <a href="https://factory.ai" className="underline hover:no-underline" target="_blank" rel="noopener noreferrer">Factory</a>.
+    </p>
+
+    <p className="max-w-3xl mt-4">
+      We&rsquo;re committed to helping maintain and evolve this as an open format that benefits the entire developer community,
+      regardless of which coding agent you use.
+    </p>
+
+    <p className="max-w-3xl mt-4">
+      AGENTS.md is now stewarded by the{" "}
+      <a href="https://aaif.io" className="underline hover:no-underline">
+        Agentic AI Foundation
+      </a>{" "}
+      under the Linux Foundation.{" "}
+      <a
+        href="https://openai.com/index/agentic-ai-foundation/"
+        className="underline hover:no-underline"
+      >
+        Learn more &rarr;
+      </a>
+    </p>
+
+  </Section>
+);
+
+export default AboutSection;

package/resources/local/agents.md/components/CodeExample.tsx

@@ -0,0 +1,207 @@
+import React from "react";
+import ClipboardIcon from "./icons/ClipboardIcon";
+import CopyIcon from "./icons/CopyIcon";
+
+interface CodeExampleProps {
+  /** Markdown content to display; falls back to default example if not provided */
+  code?: string;
+  /** Optional URL for "View on GitHub" link */
+  href?: string;
+  /** If true, render only the code block without the section wrapper */
+  compact?: boolean;
+  /** Override Tailwind height classes for the <pre> block */
+  heightClass?: string;
+
+  /**
+   * When true, vertically center the content and copy button – useful for
+   * single-line shell commands shown inside a short container (e.g. FAQ).
+   */
+  centerVertically?: boolean;
+}
+
+export const HERO_AGENTS_MD = `# AGENTS.md
+
+## Setup commands
+- Install deps: \`pnpm install\`
+- Start dev server: \`pnpm dev\`
+- Run tests: \`pnpm test\`
+
+## Code style
+- TypeScript strict mode
+- Single quotes, no semicolons
+- Use functional patterns where possible`;
+
+const EXAMPLE_AGENTS_MD = `# Sample AGENTS.md file
+
+## Dev environment tips
+- Use \`pnpm dlx turbo run where <project_name>\` to jump to a package instead \
+of scanning with \`ls\`.
+- Run \`pnpm install --filter <project_name>\` to add the package to your \
+workspace so Vite, ESLint, and TypeScript can see it.
+- Use \`pnpm create vite@latest <project_name> -- --template react-ts\` to \
+spin up a new React + Vite package with TypeScript checks ready.
+- Check the name field inside each package's package.json to confirm the \
+right name—skip the top-level one.
+
+## Testing instructions
+- Find the CI plan in the .github/workflows folder.
+- Run \`pnpm turbo run test --filter <project_name>\` to run every check \
+defined for that package.
+- From the package root you can just call \`pnpm test\`. The commit should \
+pass all tests before you merge.
+- To focus on one step, add the Vitest pattern: \`pnpm vitest run -t "<test \
+name>"\`.
+- Fix any test or type errors until the whole suite is green.
+- After moving files or changing imports, run \`pnpm lint --filter \
+<project_name>\` to be sure ESLint and TypeScript rules still pass.
+- Add or update tests for the code you change, even if nobody asked.
+
+## PR instructions
+- Title format: [<project_name>] <Title>
+- Always run \`pnpm lint\` and \`pnpm test\` before committing.`;
+
+/**
+ * Very lightly highlight the Markdown without fully parsing it.
+ */
+function parseMarkdown(md: string): React.ReactNode[] {
+  const lines = md.split("\n");
+  const elements: React.ReactNode[] = [];
+
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+
+    // Handle headers
+    if (line.startsWith("# ") || line.startsWith("## ") || line.startsWith("### ")) {
+      elements.push(
+        <div key={i} className="font-bold">
+          {line}
+        </div>
+      );
+    } else if (line.startsWith("- ")) {
+      // Handle list items with inline code
+      elements.push(
+        <div key={i}>
+          {renderLineWithInlineCode(line)}
+        </div>
+      );
+    } else if (line.trim() === "") {
+      // Handle empty lines
+      elements.push(<div key={i}>&nbsp;</div>);
+    } else {
+      // Handle regular lines with inline code
+      elements.push(
+        <div key={i}>
+          {renderLineWithInlineCode(line)}
+        </div>
+      );
+    }
+  }
+
+  return elements;
+}
+
+/**
+ * Render a line with inline code highlighting
+ */
+function renderLineWithInlineCode(line: string): React.ReactNode {
+  const parts = line.split(/(`[^`]+`)/g);
+
+  return parts.map((part, index) => {
+    if (part.startsWith("`") && part.endsWith("`")) {
+      // This is inline code
+      return (
+        <span key={index} className="bg-gray-200 dark:bg-gray-800 px-1 rounded">
+          {part}
+        </span>
+      );
+    }
+    // Regular text
+    return part;
+  });
+}
+
+/**
+ * Markdown block for AGENTS.md examples.
+ */
+export default function CodeExample({
+  code,
+  href,
+  compact = false,
+  heightClass,
+  centerVertically = false,
+}: CodeExampleProps) {
+  const md = code ?? EXAMPLE_AGENTS_MD;
+  const [copied, setCopied] = React.useState(false);
+
+  const copyToClipboard = async () => {
+    try {
+      await navigator.clipboard.writeText(md);
+      setCopied(true);
+      setTimeout(() => setCopied(false), 2000);
+    } catch (err) {
+      console.error("Failed to copy to clipboard:", err);
+    }
+  };
+
+  const content = (
+    <>
+      <div className="relative">
+        <button
+          onClick={copyToClipboard}
+          className={`absolute right-3 p-2 rounded-md bg-transparent text-gray-800 dark:text-gray-200 hover:bg-gray-100 dark:hover:bg-gray-800 transition-colors z-10 cursor-pointer ${
+            centerVertically ? "top-1/2 -translate-y-1/2" : "top-3"
+          }`}
+          aria-label="Copy to clipboard"
+        >
+          {copied ? (
+            <svg
+              className="w-4 h-4"
+              fill="none"
+              stroke="currentColor"
+              viewBox="0 0 24 24"
+            >
+              <path
+                strokeLinecap="round"
+                strokeLinejoin="round"
+                strokeWidth={2}
+                d="M5 13l4 4L19 7"
+              />
+            </svg>
+          ) : (
+            <CopyIcon className="w-4 h-4" />
+          )}
+        </button>
+        <pre
+          className={`relative rounded-lg bg-white dark:bg-black text-gray-800 dark:text-gray-100 text-xs leading-6 overflow-x-auto p-4 ${
+            centerVertically ? "flex items-center" : ""
+          } ${
+            heightClass
+              ? heightClass
+              : compact
+              ? ""
+              : "min-h-[250px] max-h-[500px]"
+          } border border-gray-200 dark:border-gray-700 shadow-sm`}
+        >
+          <code>
+            {parseMarkdown(md)}
+          </code>
+        </pre>
+      </div>
+    </>
+  );
+
+  if (compact) {
+    return <div className="w-full">{content}</div>;
+  }
+
+  return (
+    <section className="px-6 pt-10 pb-24 bg-gray-50 dark:bg-gray-900/40">
+      <div className="max-w-5xl mx-auto flex flex-col gap-6">
+        <h2 className="text-3xl font-semibold tracking-tight">
+          AGENTS.md in action
+        </h2>
+        {content}
+      </div>
+    </section>
+  );
+}