Open-source, local-first social media research agent for Instagram, TikTok, and LinkedIn. Jev routes read-only steps; socai CLI captures cited browser evidence.
JavaScript agent-skillsai-agentsbrowser-agentbrowser-automationdecision-modeldeep-researchinstagramjevlinkedinlocal-firstopen-sourceosintresearch-agentsocaisocial-listeningsocial-mediasocial-media-researchsocmintsystem-onetiktok
release: prepare v0.1.6 (#42)
Asklve205c8dc7dc5
diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.jsonindex 8cc4910..6674525 100644--- a/.codex-plugin/plugin.json+++ b/.codex-plugin/plugin.json@@ -1,6 +1,6 @@{"name": "jev-social",- "version": "0.1.5",+ "version": "0.1.6","description": "Run read-only Instagram, TikTok, and LinkedIn research through Jev-directed socai CLI operations in the user's local browser.","author": {"name": "socai-io",diff --git a/.grok-plugin/plugin.json b/.grok-plugin/plugin.jsonindex ab204b1..af026ef 100644--- a/.grok-plugin/plugin.json+++ b/.grok-plugin/plugin.json@@ -1,6 +1,6 @@{"name": "jev-social",- "version": "0.1.5",+ "version": "0.1.6","description": "Run read-only Instagram, TikTok, and LinkedIn research through Jev-directed socai CLI operations in the user's local browser.","author": {"name": "socai-io",diff --git a/README.md b/README.mdindex 9ebfb74..73de7b5 100644--- a/README.md+++ b/README.md@@ -84,14 +84,14 @@ Node 20+, an OpenRouter key with Jev access, and a current [socai](https://githuFastest path — no repository clone required. Onboarding prompts for the key and offers to install the official socai CLI when it is missing:```bash-npx github:socai-io/jev-social#v0.1.5 onboard-npx github:socai-io/jev-social#v0.1.5+npx github:socai-io/jev-social#v0.1.6 onboard+npx github:socai-io/jev-social#v0.1.6```To let Codex invoke the same browser-grounded workflow through GitHub CLI 2.101 or newer:```bash-gh skill install socai-io/jev-social [email protected] --agent codex --scope user+gh skill install socai-io/jev-social [email protected] --agent codex --scope user```Or install it from the [skills.sh directory](https://skills.sh/socai-io/jev-social/jev-social) with the cross-agent Skills CLI:@@ -100,10 +100,10 @@ Or install it from the [skills.sh directory](https://skills.sh/socai-io/jev-socinpx skills add socai-io/jev-social --skill jev-social```-For OpenCode, install the tested v0.1.5 skill into its natively discovered project skill directory:+For OpenCode, install the tested v0.1.6 skill into its natively discovered project skill directory:```bash-npx skills add https://github.com/socai-io/jev-social/tree/v0.1.5/skills/jev-social --agent opencode --yes+npx skills add https://github.com/socai-io/jev-social/tree/v0.1.6/skills/jev-social --agent opencode --yes```The skill pins the documented Jev Social CLI release, preserves its read-only and login-gate boundaries, and returns source-linked evidence instead of raw run JSON. Platform availability is checked against the installed socai CLI before a run.diff --git a/package-lock.json b/package-lock.jsonindex 2fee5e3..1aefbd1 100644--- a/package-lock.json+++ b/package-lock.json@@ -1,12 +1,12 @@{"name": "jev-social",- "version": "0.1.5",+ "version": "0.1.6","lockfileVersion": 3,"requires": true,"packages": {"": {"name": "jev-social",- "version": "0.1.5",+ "version": "0.1.6","license": "MIT","bin": {"jev-social": "bin/jev-social.js"diff --git a/package.json b/package.jsonindex 2d7da3c..05a7f5b 100644--- a/package.json+++ b/package.json@@ -1,6 +1,6 @@{"name": "jev-social",- "version": "0.1.5",+ "version": "0.1.6","description": "Jev-directed Instagram, TikTok, and LinkedIn browser operations through the socai CLI","type": "module","bin": {diff --git a/site/index.html b/site/index.htmlindex adb6a96..633ccc9 100644--- a/site/index.html+++ b/site/index.html@@ -35,7 +35,7 @@"codeRepository": "https://github.com/socai-io/jev-social","downloadUrl": "https://github.com/socai-io/jev-social/releases/latest","image": "https://socai-io.github.io/jev-social/assets/social-preview.jpg",- "softwareVersion": "0.1.5",+ "softwareVersion": "0.1.6","applicationCategory": "DeveloperApplication","operatingSystem": "macOS, Windows, Linux","isAccessibleForFree": true,@@ -208,8 +208,8 @@</div><div class="code-block"><div class="code-label">TERMINAL</div>- <pre><code><span>npx github:socai-io/jev-social#v0.1.5 onboard</span>-<span>npx github:socai-io/jev-social#v0.1.5</span></code></pre>+ <pre><code><span>npx github:socai-io/jev-social#v0.1.6 onboard</span>+<span>npx github:socai-io/jev-social#v0.1.6</span></code></pre></div><div class="run-actions"><a class="button button-pink" href="https://github.com/socai-io/jev-social" rel="noreferrer">Star Jev Social ★</a>diff --git a/site/llms.txt b/site/llms.txtindex 8413916..91577a2 100644--- a/site/llms.txt+++ b/site/llms.txt@@ -41,22 +41,22 @@ The HTTP server listens on `127.0.0.1`. State-changing requests require exact saRequirements: Node.js 20+, an OpenRouter API key with Jev access, a current socai CLI, and a Chrome session that can access the selected platform.```bash-npx github:socai-io/jev-social#v0.1.5 onboard-npx github:socai-io/jev-social#v0.1.5+npx github:socai-io/jev-social#v0.1.6 onboard+npx github:socai-io/jev-social#v0.1.6```Direct non-interactive example:```bash-npx github:socai-io/jev-social#v0.1.5 search "find emerging design creators on Instagram" --platform auto --limit 4+npx github:socai-io/jev-social#v0.1.6 search "find emerging design creators on Instagram" --platform auto --limit 4```## Install as an Agent Skill-GitHub CLI 2.101 or newer can install the immutable v0.1.5 skill for Codex:+GitHub CLI 2.101 or newer can install the immutable v0.1.6 skill for Codex:```bash-gh skill install socai-io/jev-social [email protected] --agent codex --scope user+gh skill install socai-io/jev-social [email protected] --agent codex --scope user```The cross-agent Skills CLI is also supported:@@ -65,10 +65,10 @@ The cross-agent Skills CLI is also supported:npx skills add socai-io/jev-social --skill jev-social```-OpenCode can install the tested v0.1.5 Skill into its natively discovered project directory:+OpenCode can install the tested v0.1.6 Skill into its natively discovered project directory:```bash-npx skills add https://github.com/socai-io/jev-social/tree/v0.1.5/skills/jev-social --agent opencode --yes+npx skills add https://github.com/socai-io/jev-social/tree/v0.1.6/skills/jev-social --agent opencode --yes```This is a standard Agent Skill that calls the local socai CLI, not an OpenCode plugin.diff --git a/skills/jev-social/SKILL.md b/skills/jev-social/SKILL.mdindex f4a7a87..9a17b2f 100644--- a/skills/jev-social/SKILL.md+++ b/skills/jev-social/SKILL.md@@ -26,17 +26,17 @@ Do not install software, start onboarding, change browser profiles, or request cRun this before research:```bash-npx github:socai-io/jev-social#782d809c68e2015536359aa7dceede9a3cdbb7f1 status+npx github:socai-io/jev-social#f265915b2353c3730b1e93e4ca1291627e6ffd94 status```-The commit is the tested runtime source included in release `v0.1.5`. Do not add an automatic-consent flag. If the package runner needs to download the source, identify `socai-io/jev-social` and the pinned commit to the user, then continue only after the user approves that download.+The commit is the tested runtime source included in release `v0.1.6`. Do not add an automatic-consent flag. If the package runner needs to download the source, identify `socai-io/jev-social` and the pinned commit to the user, then continue only after the user approves that download.Require a configured Jev key, an installed socai CLI, and support for the requested platform. Treat the status payload as local diagnostics: do not reproduce configuration paths, executable paths, environment values, or credentials in the answer.If setup is missing, identify the exact missing prerequisite. Run interactive onboarding or install software only when the user requested setup or authorized installation:```bash-npx github:socai-io/jev-social#782d809c68e2015536359aa7dceede9a3cdbb7f1 onboard+npx github:socai-io/jev-social#f265915b2353c3730b1e93e4ca1291627e6ffd94 onboard```Never place an API key in a shell command, transcript, report, or committed file.@@ -46,7 +46,7 @@ Never place an API key in a shell command, transcript, report, or committed fileUse the platform named by the user. Otherwise leave routing to Jev with `auto`. Keep the natural-language goal intact; it can include desired evidence, target counts, and stopping conditions.```bash-npx github:socai-io/jev-social#782d809c68e2015536359aa7dceede9a3cdbb7f1 search "<research goal>" \+npx github:socai-io/jev-social#f265915b2353c3730b1e93e4ca1291627e6ffd94 search "<research goal>" \--platform <auto|instagram|tiktok|linkedin> \--limit 4 \--max-steps 12@@ -80,7 +80,7 @@ Lead with the outcome, then present the useful records in a compact table or shoWhen the user asks for an interactive preview instead of a terminal run, start the loopback UI with:```bash-npx github:socai-io/jev-social#782d809c68e2015536359aa7dceede9a3cdbb7f1 serve --port 8766+npx github:socai-io/jev-social#f265915b2353c3730b1e93e4ca1291627e6ffd94 serve --port 8766```Report `http://127.0.0.1:8766` and leave the process running only when the user asked for a local demo server.diff --git a/test/distribution-docs.test.js b/test/distribution-docs.test.jsindex 4153472..25732be 100644--- a/test/distribution-docs.test.js+++ b/test/distribution-docs.test.js@@ -5,6 +5,7 @@ import test from "node:test";const packageJson = JSON.parse(await readFile(new URL("../package.json", import.meta.url), "utf8"),);+const releaseTag = `v${packageJson.version}`;const pinnedSource = `github:socai-io/jev-social#v${packageJson.version}`;const publicDocs = [["README.md", new URL("../README.md", import.meta.url)],@@ -34,6 +35,22 @@ test("machine-readable setup avoids command-line credentials and exposes the Age);});+test("package, plugin manifests, and Agent Skill identify the current release", async () => {+ const [codexManifest, grokManifest, skill] = await Promise.all([+ readFile(new URL("../.codex-plugin/plugin.json", import.meta.url), "utf8").then(JSON.parse),+ readFile(new URL("../.grok-plugin/plugin.json", import.meta.url), "utf8").then(JSON.parse),+ readFile(new URL("../skills/jev-social/SKILL.md", import.meta.url), "utf8"),+ ]);++ assert.equal(codexManifest.version, packageJson.version);+ assert.equal(grokManifest.version, packageJson.version);+ assert.ok(skill.includes(`release \`${releaseTag}\``));++ const runtimePins = skill.match(/github:socai-io\/jev-social#[0-9a-f]{40}/g) ?? [];+ assert.ok(runtimePins.length > 0, "the Agent Skill must pin an immutable runtime commit");+ assert.equal(new Set(runtimePins).size, 1, "all Agent Skill commands must use one runtime commit");+});+test("the Pages artifact retains the .nojekyll marker", async () => {const workflow = await readFile(new URL("../.github/workflows/pages.yml", import.meta.url), "utf8");assert.match(workflow, /touch _site\/\.nojekyll/);