@listeningkit/log 0.3.0 → 0.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +9 -7
- package/README.md +38 -52
- package/docs/README.md +4 -0
- package/docs/accounts.md +9 -2
- package/docs/accountsAndListings.md +4 -0
- package/docs/adsPower.md +4 -0
- package/docs/antigravityHooks.md +4 -0
- package/docs/browserIdentity.md +4 -0
- package/docs/browserSetup.md +4 -0
- package/docs/browsers.md +4 -0
- package/docs/callTiming.md +4 -0
- package/docs/commandNaming.md +6 -0
- package/docs/contextLayer.md +4 -0
- package/docs/contributing.md +8 -0
- package/docs/conversations.md +4 -0
- package/docs/decisions/README.md +49 -0
- package/docs/decisions/agentTrust/docsAudit.md +221 -0
- package/docs/decisions/agentTrust/judgeMatrix.md +59 -0
- package/docs/decisions/agentTrust/research.md +162 -0
- package/docs/decisions/encryptedStore/research.md +127 -0
- package/docs/decisions/mcpReload/readme_mcpmon.md +11 -11
- package/docs/decisions/mcpReload/readme_reloaderoo.md +4 -4
- package/docs/decisions/slopDetector/repos.md +8 -8
- package/docs/deployment.md +4 -0
- package/docs/diagrams/commands.mmd +3 -0
- package/docs/diagrams/platforms.mmd +2 -2
- package/docs/diagrams/surface.mmd +2 -2
- package/docs/errorCatalog.md +8 -0
- package/docs/groupListening.md +4 -0
- package/docs/groupMembers.md +4 -0
- package/docs/groupRead.md +4 -0
- package/docs/guides/discord.md +18 -15
- package/docs/guides/facebookBrowser.md +2 -2
- package/docs/guides/facebookMarketplace.md +1 -1
- package/docs/guides/governor.md +1 -1
- package/docs/guides/inbox.md +2 -2
- package/docs/guides/logMcpInstructions.md +10 -8
- package/docs/guides/runsAndEvidence.md +3 -1
- package/docs/guides/voiceGate.md +3 -2
- package/docs/guides/xInbox.md +1 -1
- package/docs/guides/xSending.md +5 -5
- package/docs/harnesses/README.md +5 -0
- package/docs/harnesses/chatgpt.md +5 -0
- package/docs/harnesses/claudeApp.md +5 -0
- package/docs/harnesses/codex.md +5 -0
- package/docs/harnesses/cursor.md +5 -0
- package/docs/harnesses/grok.md +5 -0
- package/docs/harnesses/hermes.md +5 -0
- package/docs/hookStartup.md +4 -0
- package/docs/howItWorks.md +12 -0
- package/docs/install.md +7 -1
- package/docs/knowledgeBase.md +4 -0
- package/docs/layout.md +4 -0
- package/docs/lifecycle.md +4 -0
- package/docs/listingMedia.md +4 -0
- package/docs/listingMonitor.md +4 -0
- package/docs/liveInbox.md +4 -0
- package/docs/mcp.md +6 -0
- package/docs/models.md +111 -38
- package/docs/namingConventions.md +4 -0
- package/docs/opencodeHooks.md +4 -0
- package/docs/pipelineLabels.md +5 -1
- package/docs/platformGuides/discord.md +5 -0
- package/docs/platformGuides/facebook.md +5 -0
- package/docs/platformGuides/linkedin.md +5 -0
- package/docs/platformGuides/reddit.md +5 -0
- package/docs/platformGuides/slack.md +5 -0
- package/docs/platformGuides/x.md +5 -0
- package/docs/platforms/discord/background/discordApiApplicationsAssets.md +68 -0
- package/docs/platforms/discord/background/discordApiApplicationsPublic.md +545 -591
- package/docs/platforms/discord/background/discordApiAuthLocationMetadata.md +34 -12
- package/docs/platforms/discord/background/discordApiBeaker.md +155 -0
- package/docs/platforms/discord/background/discordApiChannelsMessages.md +170 -198
- package/docs/platforms/discord/background/discordApiChannelsMessagesAck.md +9 -7
- package/docs/platforms/discord/background/discordApiCollectiblesCollectionSequencedOffers.md +34 -12
- package/docs/platforms/discord/background/discordApiCollectiblesProducts.md +227 -0
- package/docs/platforms/discord/background/discordApiCollectiblesShop.md +301 -57
- package/docs/platforms/discord/background/discordApiContentInventoryUsersMe.md +221 -220
- package/docs/platforms/discord/background/discordApiDismissibleContentArbitrate.md +13 -9
- package/docs/platforms/discord/background/discordApiGames.md +240 -280
- package/docs/platforms/discord/background/discordApiGamesDetectableExclusions.md +9 -10
- package/docs/platforms/discord/background/discordApiGuildsNewMemberActions.md +83 -0
- package/docs/platforms/discord/background/discordApiGuildsNewMemberWelcome.md +183 -0
- package/docs/platforms/discord/background/discordApiMetrics.md +152 -27
- package/docs/platforms/discord/background/discordApiPartnerSdkStorefrontConfig.md +9 -10
- package/docs/platforms/discord/background/discordApiPromotions.md +222 -298
- package/docs/platforms/discord/background/discordApiQuestsDecision.md +31 -32
- package/docs/platforms/discord/background/discordApiQuestsGetDecisions.md +168 -44
- package/docs/platforms/discord/background/discordApiQuestsMe.md +54 -54
- package/docs/platforms/discord/background/discordApiScience.md +279 -264
- package/docs/platforms/discord/background/discordApiStorefrontProductsSkus.md +309 -0
- package/docs/platforms/discord/background/discordApiStorefrontPromotions.md +29 -90
- package/docs/platforms/discord/background/discordApiTokens.md +29 -10
- package/docs/platforms/discord/background/discordApiUsersApplicationIdentities.md +81 -0
- package/docs/platforms/discord/background/discordApiUsersBadges.md +281 -257
- package/docs/platforms/discord/background/discordApiUsersMe.md +49 -10
- package/docs/platforms/discord/background/discordApiUsersMeAchievementsUnreadState.md +73 -0
- package/docs/platforms/discord/background/discordApiUsersMeAffinitiesGuilds.md +43 -45
- package/docs/platforms/discord/background/discordApiUsersMeAffinitiesUsers.md +151 -153
- package/docs/platforms/discord/background/discordApiUsersMeApplicationsEntitlements.md +9 -10
- package/docs/platforms/discord/background/discordApiUsersMeBillingCheckoutRecovery.md +9 -10
- package/docs/platforms/discord/background/discordApiUsersMeBillingPaymentSources.md +36 -6
- package/docs/platforms/discord/background/discordApiUsersMeBillingSubscriptions.md +18 -190
- package/docs/platforms/discord/background/discordApiUsersMeBillingUserOffer.md +12 -17
- package/docs/platforms/discord/background/discordApiUsersMeCollectiblesMarketing.md +11 -94
- package/docs/platforms/discord/background/discordApiUsersMeEntitlements.md +9 -10
- package/docs/platforms/discord/background/discordApiUsersMeMfaWebauthnCredentials.md +12 -37
- package/docs/platforms/discord/background/discordApiUsersMeNotes.md +42 -6
- package/docs/platforms/discord/background/discordApiUsersMeReferralsEligibility.md +8 -9
- package/docs/platforms/discord/background/discordApiUsersMeSavedMessages.md +9 -10
- package/docs/platforms/discord/background/discordApiUsersMeSettingsProto.md +13 -10
- package/docs/platforms/discord/background/discordApiUsersMeSurvey.md +12 -13
- package/docs/platforms/discord/background/discordApiUsersMeVirtualCurrencyBalance.md +71 -0
- package/docs/platforms/discord/background/discordApiUsersProfile.md +137 -97
- package/docs/platforms/discord/background/discordApiWidgetConfigsDeveloper.md +55 -0
- package/docs/platforms/discord/background/discordApiWidgetConfigsFeatured.md +286 -0
- package/docs/platforms/discord/background/discordApiWishlists.md +367 -0
- package/docs/platforms/discord/background/discordAssets.md +36 -6
- package/docs/platforms/discord/background/discordAssetsVersionStableJson.md +15 -16
- package/docs/platforms/discord/background/discordCdnCgiChallengePlatformHBJsdOneshot.md +37 -7
- package/docs/platforms/discord/background/statusApiIncidentsUnresolvedJson.md +85 -0
- package/docs/platforms/discord/background/statusApiScheduledMaintenancesActiveJson.md +85 -0
- package/docs/platforms/discord/background/statusApiScheduledMaintenancesUpcomingJson.md +12 -13
- package/docs/platforms/discord/operations.json +206 -80
- package/docs/platforms/facebook/operations.json +2 -2
- package/docs/proxies.md +4 -0
- package/docs/recordToFlow.md +4 -0
- package/docs/reference.md +38 -22
- package/docs/relateGraph.md +4 -0
- package/docs/security/encryptedStore.md +67 -0
- package/docs/signingIn.md +4 -0
- package/docs/site.json +2 -2
- package/docs/specs/search.md +1 -1
- package/docs/status.md +4 -0
- package/docs/storageAgainstTheBook.md +4 -0
- package/docs/storageReadPath.md +4 -0
- package/docs/toolCallSpeed.md +4 -0
- package/docs/toolCallsAgainstTheBook.md +4 -0
- package/docs/trust.md +90 -0
- package/docs/twenty.md +4 -0
- package/docs/twitterPlatform.md +4 -0
- package/docs/unifyStorage.md +4 -0
- package/docs/updates.md +8 -13
- package/docs/useCases/README.md +28 -0
- package/docs/useCases/discord/channelReply.md +6 -0
- package/docs/useCases/discord/coldOutbound.md +53 -0
- package/docs/useCases/discord/forumPosts.md +6 -0
- package/docs/useCases/discord/groupChatRead.md +6 -0
- package/docs/useCases/discord/memeReply.md +6 -0
- package/docs/useCases/discord/serverReply.md +6 -0
- package/docs/useCases/discord/serverSearch.md +6 -0
- package/docs/useCases/facebook/groups.md +6 -0
- package/docs/useCases/facebook/marketplaceListings.md +7 -1
- package/docs/useCases/inbox/bossMaxxing.md +5 -0
- package/docs/useCases/inbox/governorReset.md +5 -0
- package/docs/useCases/inbox/ignoreServer.md +5 -0
- package/docs/useCases/inbox/labelQueue.md +5 -0
- package/docs/useCases/inbox/outcomes.md +5 -0
- package/docs/useCases/inbox/quietPush.md +5 -0
- package/docs/useCases/inbox/reaLooksmaxxing.md +5 -0
- package/docs/useCases/inbox/reactions.md +5 -0
- package/docs/useCases/inbox/saidBy.md +5 -0
- package/docs/useCases/inbox/scopeAJob.md +5 -0
- package/docs/useCases/inbox/showMe.md +5 -0
- package/docs/useCases/inbox/signIn.md +6 -1
- package/docs/useCases/inbox/triage.md +5 -0
- package/docs/useCases/inbox/voiceNote.md +5 -0
- package/docs/useCases/inbox/warmPeople.md +5 -0
- package/docs/useCases/instagram/dmReply.md +5 -0
- package/docs/useCases/instagram/newPlatform.md +5 -0
- package/docs/useCases/linkedin/network.md +6 -0
- package/docs/useCases/linkedin/posts.md +6 -0
- package/docs/useCases/log/browserMove.md +6 -1
- package/docs/useCases/log/localModels.md +6 -1
- package/docs/useCases/log/secretStore.md +41 -0
- package/docs/useCases/log/toolFromOneOff.md +5 -0
- package/docs/useCases/log/toolHealth.md +5 -0
- package/docs/useCases/log/updateLog.md +5 -0
- package/docs/useCases/reddit/contributorMaxxing.md +6 -0
- package/docs/useCases/slack/dmReply.md +6 -0
- package/docs/useCases/tiktok/post.md +5 -0
- package/docs/useCases/twitter/README.md +6 -0
- package/docs/useCases/twitter/affiliateMarketing.md +7 -0
- package/docs/useCases/twitter/collabMaxxing.md +7 -0
- package/docs/useCases/twitter/dmInbox.md +7 -0
- package/docs/useCases/twitter/engagementReplies.md +7 -0
- package/docs/useCases/twitter/engagerDms.md +9 -3
- package/docs/useCases/twitter/followUps.md +7 -0
- package/docs/useCases/twitter/followers.md +7 -0
- package/docs/useCases/twitter/getTheAction.md +7 -0
- package/docs/useCases/twitter/managerMaxxing.md +10 -3
- package/docs/useCases/twitter/networkMaxing.md +8 -1
- package/docs/useCases/twitter/nicheMapRegion.md +9 -2
- package/docs/useCases/twitter/notifications.md +7 -0
- package/docs/useCases/twitter/recruiting.md +7 -0
- package/docs/useCases/twitter/replyGuyFunnel.md +8 -1
- package/docs/useCases/twitter/topicReplies.md +7 -0
- package/docs/useCases/twitter/whoNeedsYou.md +7 -0
- package/docs/useCases/web/competitorTraffic.md +5 -0
- package/docs/usingLog.md +6 -0
- package/docs/voiceNotes.md +4 -0
- package/hermesPlugin/README.md +1 -1
- package/hermesPlugin/dashboard/manifest.json +1 -1
- package/hermesPlugin/plugin.yaml +1 -1
- package/hermesPlugin/skills/log-discord-channel-reply/SKILL.md +6 -0
- package/hermesPlugin/skills/log-discord-cold-outbound/SKILL.md +47 -0
- package/hermesPlugin/skills/log-discord-forum-posts/SKILL.md +6 -0
- package/hermesPlugin/skills/log-discord-group-chat-read/SKILL.md +6 -0
- package/hermesPlugin/skills/log-discord-meme-reply/SKILL.md +6 -0
- package/hermesPlugin/skills/log-discord-server-reply/SKILL.md +6 -0
- package/hermesPlugin/skills/log-discord-server-search/SKILL.md +6 -0
- package/hermesPlugin/skills/log-facebook-groups/SKILL.md +6 -0
- package/hermesPlugin/skills/log-inbox-boss-maxxing/SKILL.md +5 -0
- package/hermesPlugin/skills/log-inbox-governor-reset/SKILL.md +5 -0
- package/hermesPlugin/skills/log-inbox-ignore-server/SKILL.md +5 -0
- package/hermesPlugin/skills/log-inbox-label-queue/SKILL.md +5 -0
- package/hermesPlugin/skills/log-inbox-outcomes/SKILL.md +5 -0
- package/hermesPlugin/skills/log-inbox-quiet-push/SKILL.md +5 -0
- package/hermesPlugin/skills/log-inbox-rea-looksmaxxing/SKILL.md +5 -0
- package/hermesPlugin/skills/log-inbox-reactions/SKILL.md +5 -0
- package/hermesPlugin/skills/log-inbox-said-by/SKILL.md +5 -0
- package/hermesPlugin/skills/log-inbox-scope-ajob/SKILL.md +5 -0
- package/hermesPlugin/skills/log-inbox-show-me/SKILL.md +5 -0
- package/hermesPlugin/skills/log-inbox-sign-in/SKILL.md +6 -1
- package/hermesPlugin/skills/log-inbox-triage/SKILL.md +5 -0
- package/hermesPlugin/skills/log-inbox-voice-note/SKILL.md +5 -0
- package/hermesPlugin/skills/log-inbox-warm-people/SKILL.md +5 -0
- package/hermesPlugin/skills/log-instagram-dm-reply/SKILL.md +5 -0
- package/hermesPlugin/skills/log-instagram-new-platform/SKILL.md +5 -0
- package/hermesPlugin/skills/log-linkedin-network/SKILL.md +6 -0
- package/hermesPlugin/skills/log-linkedin-posts/SKILL.md +6 -0
- package/hermesPlugin/skills/log-log-browser-move/SKILL.md +6 -1
- package/hermesPlugin/skills/log-log-local-models/SKILL.md +6 -1
- package/hermesPlugin/skills/log-log-secret-store/SKILL.md +43 -0
- package/hermesPlugin/skills/log-log-tool-from-one-off/SKILL.md +5 -0
- package/hermesPlugin/skills/log-log-tool-health/SKILL.md +5 -0
- package/hermesPlugin/skills/log-log-update-log/SKILL.md +5 -0
- package/hermesPlugin/skills/log-reddit-contributor-maxxing/SKILL.md +6 -0
- package/hermesPlugin/skills/log-slack-dm-reply/SKILL.md +6 -0
- package/hermesPlugin/skills/log-tiktok-post/SKILL.md +5 -0
- package/hermesPlugin/skills/log-twitter-affiliate-marketing/SKILL.md +7 -0
- package/hermesPlugin/skills/log-twitter-collab-maxxing/SKILL.md +7 -0
- package/hermesPlugin/skills/log-twitter-dm-inbox/SKILL.md +7 -0
- package/hermesPlugin/skills/log-twitter-engagement-replies/SKILL.md +7 -0
- package/hermesPlugin/skills/log-twitter-engager-dms/SKILL.md +9 -2
- package/hermesPlugin/skills/log-twitter-follow-ups/SKILL.md +7 -0
- package/hermesPlugin/skills/log-twitter-followers/SKILL.md +7 -0
- package/hermesPlugin/skills/log-twitter-get-the-action/SKILL.md +7 -0
- package/hermesPlugin/skills/log-twitter-manager-maxxing/SKILL.md +11 -4
- package/hermesPlugin/skills/log-twitter-network-maxing/SKILL.md +8 -1
- package/hermesPlugin/skills/log-twitter-niche-map-region/SKILL.md +8 -1
- package/hermesPlugin/skills/log-twitter-notifications/SKILL.md +7 -0
- package/hermesPlugin/skills/log-twitter-recruiting/SKILL.md +7 -0
- package/hermesPlugin/skills/log-twitter-reply-guy-funnel/SKILL.md +8 -1
- package/hermesPlugin/skills/log-twitter-topic-replies/SKILL.md +7 -0
- package/hermesPlugin/skills/log-twitter-who-needs-you/SKILL.md +7 -0
- package/hermesPlugin/skills/log-web-competitor-traffic/SKILL.md +5 -0
- package/package.json +4 -2
- package/python/discordApi/browserRest.py +1 -0
- package/python/discordApi/engine.py +71 -2
- package/python/errors/errorCatalog.json +73 -0
- package/python/platformKit/engine.py +9 -4
- package/python/secretStore/__init__.py +249 -0
- package/python/twitterApi/engine.py +6 -2
- package/scripts/checks/agentWordingBaseline.json +1 -0
- package/scripts/checks/agnosticBaseline.json +22 -22
- package/scripts/checks/checkAgentWording.ts +73 -0
- package/scripts/checks/checkDocLinks.ts +126 -0
- package/scripts/checks/checkNamingConventions.mjs +1 -1
- package/scripts/checks/checkOneDatabase.ts +6 -4
- package/scripts/checks/docLinksBaseline.json +1061 -0
- package/skills/accountToDryRun/SKILL.md +1 -1
- package/skills/discordServers/SKILL.md +5 -5
- package/skills/host/SKILL.md +2 -2
- package/skills/xPosting/SKILL.md +3 -3
- package/src/auth/credentials/client.ts +24 -22
- package/src/billing/balance/client.ts +12 -9
- package/src/cli/balance/index.ts +3 -2
- package/src/cli/discord/index.ts +116 -17
- package/src/cli/inbox/index.ts +36 -11
- package/src/cli/runner/client.ts +1 -0
- package/src/cli/runner/helpers/commandIndex.ts +1 -0
- package/src/cli/runner/index.ts +2 -1
- package/src/cli/runner/types.ts +2 -0
- package/src/cli/storage/index.ts +102 -7
- package/src/config/userEnv/index.ts +70 -3
- package/src/directApi/engine/client.ts +1 -0
- package/src/errors/catalog/types.ts +56 -0
- package/src/extensions/treg/client.ts +2 -1
- package/src/extensions/treg/types.ts +2 -0
- package/src/mcp/server/helpers/agentRules.ts +1 -0
- package/src/mcp/server/helpers/guides.ts +3 -3
- package/src/mcp/server/helpers/playGate.ts +1 -1
- package/src/platformKit/session/client.ts +25 -13
- package/src/release/postInstall/helpers/effects.ts +1 -1
- package/src/search/conversations/helpers/embed.ts +20 -6
- package/src/search/conversations/types.ts +1 -0
- package/src/specs/search/index.ts +4 -0
- package/src/storage/schema/helpers/migrations.ts +13 -0
- package/src/storage/secrets/client.ts +320 -0
- package/src/storage/secrets/helpers/envelope.ts +29 -0
- package/src/storage/secrets/helpers/index.ts +2 -0
- package/src/storage/secrets/helpers/keystores.ts +92 -0
- package/src/storage/secrets/index.ts +2 -0
- package/src/storage/secrets/types.ts +45 -0
- package/src/twenty/graphql/helpers/localAccounts.ts +98 -6
- package/src/twitter/account/session/client.ts +24 -8
- package/src/useCases/router/fixtures/tools.json +7 -5
package/AGENTS.md
CHANGED
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
# AGENTS.md — Log
|
|
2
2
|
|
|
3
|
+
> **Reviewing log for someone, not working on it?** This file is the rulebook for agents that change log's code. To judge whether to install it, read [docs/trust.md](docs/trust.md) (what the owner controls, what log never does, where data lives, how to check each point) and the top of the [README](README.md).
|
|
4
|
+
|
|
3
5
|
Current instructions, consolidated at The owner's request on 11 November 2026.
|
|
4
6
|
|
|
5
7
|
## Current implementation scope
|
|
@@ -26,7 +28,7 @@ For platform work, read the relevant skill/use-case and current domain spec. Pla
|
|
|
26
28
|
|
|
27
29
|
2. 2026-10-18 · Put platform code under src/<platform>/<area>/<domain>; shared code stays in its shared library/domain. Use index.ts, types.ts, client.ts, machine.ts and helpers where appropriate. Keep scripts and Python in domain folders.
|
|
28
30
|
|
|
29
|
-
4. 2026-10-18 · Commit and push as The owner to GitHub origin. Preserve unrelated work and inspect current changes before editing. Never
|
|
31
|
+
4. 2026-10-18 · Commit and push as The owner to GitHub origin. Preserve unrelated work and inspect current changes before editing. Never skip hooks.
|
|
30
32
|
|
|
31
33
|
5. 2026-10-18 · Each commit needs its AST-backed day-log entry, written by the pre-commit hook to the private devlog (`LOG_DEVLOG_DIR`, default `~/.logCli/devlog/<UTC-date>.md`), never into the repo. Follow skills/commitLog/SKILL.md; never fabricate or hand-edit the generated AST evidence.
|
|
32
34
|
|
|
@@ -78,19 +80,19 @@ For platform work, read the relevant skill/use-case and current domain spec. Pla
|
|
|
78
80
|
|
|
79
81
|
83. 2026-10-25 · New platforms use the existing scaffold, shared account/session boundary, command/catalog wiring, platform documentation and spec anchors. Native hosted scaffolds must not recreate a Twenty dependency.
|
|
80
82
|
|
|
81
|
-
86. 2026-10-26 · Governor, waking-hours, voice-gate and other
|
|
83
|
+
86. 2026-10-26 · Governor, waking-hours, voice-gate and other overrides apply only when The owner asks for the specific supported override. Overrides never disable unrelated gates.
|
|
82
84
|
|
|
83
85
|
89. 2026-10-26 · Find conversational context by scoped search and existing private records. Do not reread every thread for a single person or task.
|
|
84
86
|
|
|
85
87
|
90. 2026-10-28 · Preserve platform message splitting: draft lines send as separate messages unless The owner explicitly requests the supported asOne behavior.
|
|
86
88
|
|
|
87
|
-
94. 2026-10-29 · Every platform call goes through Log and its governor, never a scratch client with account tokens/cookies. A refusal, failed send, 429, block, disable,
|
|
89
|
+
94. 2026-10-29 · Every platform call goes through Log and its governor, never a scratch client with account tokens/cookies. A refusal, failed send, 429, block, disable, challenge or cooldown stops that run/account until The owner authorizes continuation. Do not retry through refusals. Bulk reading and sending are separate sessions; new contacts stay a few a day, minutes apart, and opening a DM counts as a write. Live-view input: a browser the agent opened takes it only on sign-in pages, one the owner opened to drive on every page (2026-11-20).
|
|
88
90
|
|
|
89
91
|
103. 2026-10-31 · The public log repository on origin is the working repository. Keep archived repository references as history, not implementation destinations.
|
|
90
92
|
|
|
91
|
-
105. 2026-11-01 · One platform/account owns one continuous engine session and push connection. Reads, writes, queues and watches share that owner through existing relay/serialization. Never
|
|
93
|
+
105. 2026-11-01 · One platform/account owns one continuous engine session and push connection. Reads, writes, queues and watches share that owner through existing relay/serialization. Never go around the owner or its governor with a parallel client.
|
|
92
94
|
|
|
93
|
-
109. 2026-11-01 · Read the full relevant chat and current private context before drafting or sending. Include media/transcript/attachment context and pending queued actions; hold a send if required context cannot be obtained. Follow the selected channel's voice and task-brief contract.
|
|
95
|
+
109. 2026-11-01 · Read the full relevant chat and current private context before drafting or sending. Include media/transcript/attachment context and pending queued actions; hold a send if required context cannot be obtained. Follow the selected channel's voice and task-brief contract. New contacts exclude existing conversations through the current prior-conversation check; skip it only when The owner asks.
|
|
94
96
|
|
|
95
97
|
117. 2026-11-02 · Current behavior belongs in its domain spec with code anchors; generator/wiring changes update that spec and relevant use cases. Distinguish implemented anchors from future design. Rule 170 governs which checks run automatically.
|
|
96
98
|
|
|
@@ -112,7 +114,7 @@ For platform work, read the relevant skill/use-case and current domain spec. Pla
|
|
|
112
114
|
|
|
113
115
|
158. 2026-11-07 · Select the relevant guide/use case from the task. Read the guide before using its Log tools and carry context across the full workflow; do not require The owner to remember internal command names.
|
|
114
116
|
|
|
115
|
-
160. 2026-11-07 · Answer eligible chat reads from log.db when the owner is live, caught up and the needed history is present/backfilled. Otherwise fill the missing scope once through the owner. A refused catch-up is a refusal, never a reason to
|
|
117
|
+
160. 2026-11-07 · Answer eligible chat reads from log.db when the owner is live, caught up and the needed history is present/backfilled. Otherwise fill the missing scope once through the owner. A refused catch-up is a refusal, never a reason to skip it with another live read. Report the read source.
|
|
116
118
|
|
|
117
119
|
163. 2026-11-07 · Agent Log actions go through Log MCP tools; never work around a stale or unavailable MCP with shell Log commands or scratch clients. Terminal-only credential prompts remain for The owner. Expose discoverable command contracts through the existing Log catalog: search the job, get exact inputs, then call. Keep tool descriptions concise and accurate to the current implementation.
|
|
118
120
|
|
|
@@ -120,7 +122,7 @@ For platform work, read the relevant skill/use-case and current domain spec. Pla
|
|
|
120
122
|
|
|
121
123
|
165. 2026-11-07 · Preserve per-stage call timings in the private observability store so latency can be traced to its cause. Keep proposed central metadata free of private payloads.
|
|
122
124
|
|
|
123
|
-
167. 2026-11-07 · Use supported MCP/runtime reload behavior for changes. Avoid restarting healthy sessions unnecessarily; never silently interrupt active account work or
|
|
125
|
+
167. 2026-11-07 · Use supported MCP/runtime reload behavior for changes. Avoid restarting healthy sessions unnecessarily; never silently interrupt active account work or skip owner locks.
|
|
124
126
|
|
|
125
127
|
168. 2026-11-08 · Reset governor or browser-launch counts only when The owner explicitly asks, using the existing recorded reset command. A code/schema migration is not authorization to reset them.
|
|
126
128
|
|
package/README.md
CHANGED
|
@@ -7,8 +7,8 @@
|
|
|
7
7
|
<br><sub>Introducing log, in collaboration with Hermes Agent. <a href="https://x.com/i/status/2120938715820474690">Watch the launch video with sound on X →</a></sub>
|
|
8
8
|
</p>
|
|
9
9
|
|
|
10
|
-
<h3 align="center">
|
|
11
|
-
<p align="center"><b>Read and
|
|
10
|
+
<h3 align="center">Your agent answers your DMs in your voice. Nothing sends until you approve it.</h3>
|
|
11
|
+
<p align="center"><b>Read and reply to the people you already talk to on X, Discord, Slack, Instagram, Reddit, LinkedIn and Facebook<br>
|
|
12
12
|
from your terminal, or from any agent: Claude Code, Codex, Cursor, Hermes, OpenCode, ChatGPT, Claude and Grok.</b><br>
|
|
13
13
|
<a href="docs/useCases/README.md">See every play, step by step →</a></p>
|
|
14
14
|
|
|
@@ -24,6 +24,25 @@ curl -fsSL https://log.listeningkit.com/install.sh | sh
|
|
|
24
24
|
claude mcp add log -- logMcp
|
|
25
25
|
```
|
|
26
26
|
|
|
27
|
+
## You stay in control
|
|
28
|
+
|
|
29
|
+
| Control | How it works |
|
|
30
|
+
|---|---|
|
|
31
|
+
| **You approve every send** | Replies are set to `ask` by default: the agent shows you the draft and waits for your yes. Every command that changes something is a dry run until `--live`. |
|
|
32
|
+
| **Your voice, checked** | Each draft is scored against how you really write to that person before it can go out ([docs/voice](docs/voice)). |
|
|
33
|
+
| **Hard daily limits** | Each account has its own read and write budget (500 reads and 240 writes a day on X), quiet hours, and pacing. A refusal from the platform stops the run and nothing is retried. |
|
|
34
|
+
| **One session per account** | Your own accounts, signed in by you, one connection each, the way the platform's own app works. |
|
|
35
|
+
| **Messages in are checked too** | Prompt injection, token stealers and encoded scripts are held before your agent reads them. |
|
|
36
|
+
| **Everything is recorded** | Every read, draft, approval and send is written to a local database (`~/.logCli/log.db`) you can query. |
|
|
37
|
+
| **Your agent never sees your sign-ins** | You type them once in a terminal; agents are refused from those commands, no tool returns them, and log makes each request itself. |
|
|
38
|
+
| **Your data stays on your machine** | Sessions and messages live in `~/.logCli`. Hosted services see only what their job needs, never a sign-in: [what leaves your machine](docs/trust.md#what-leaves-your-machine). |
|
|
39
|
+
|
|
40
|
+
**What log will not do:** send anything you didn't approve, collect or sell other people's data, or run accounts that aren't yours. More: [docs/trust.md](docs/trust.md).
|
|
41
|
+
|
|
42
|
+
**Asking an AI whether to install it?** Ask [Claude](https://claude.ai/new?q=I%27m%20deciding%20whether%20to%20install%20log%2C%20an%20open-source%20tool%20that%20lets%20my%20AI%20agent%20read%20and%20reply%20to%20my%20own%20social%20accounts%3A%20https%3A//github.com/matthewdonsemail-lab/log%0A%0ARead%20https%3A//github.com/matthewdonsemail-lab/log/blob/main/docs/trust.md%20first%2C%20then%20the%20README.%20Tell%20me%3A%20what%20it%20does%2C%20what%20it%20can%20send%20and%20when%20it%20needs%20my%20approval%2C%20where%20my%20sign-ins%20and%20messages%20are%20kept%2C%20what%20it%20will%20not%20do%2C%20and%20the%20risks%20for%20my%20accounts.%20Point%20to%20the%20file%20for%20each%20answer.), [ChatGPT](https://chatgpt.com/?q=I%27m%20deciding%20whether%20to%20install%20log%2C%20an%20open-source%20tool%20that%20lets%20my%20AI%20agent%20read%20and%20reply%20to%20my%20own%20social%20accounts%3A%20https%3A//github.com/matthewdonsemail-lab/log%0A%0ARead%20https%3A//github.com/matthewdonsemail-lab/log/blob/main/docs/trust.md%20first%2C%20then%20the%20README.%20Tell%20me%3A%20what%20it%20does%2C%20what%20it%20can%20send%20and%20when%20it%20needs%20my%20approval%2C%20where%20my%20sign-ins%20and%20messages%20are%20kept%2C%20what%20it%20will%20not%20do%2C%20and%20the%20risks%20for%20my%20accounts.%20Point%20to%20the%20file%20for%20each%20answer.) or [Perplexity](https://www.perplexity.ai/search?q=I%27m%20deciding%20whether%20to%20install%20log%2C%20an%20open-source%20tool%20that%20lets%20my%20AI%20agent%20read%20and%20reply%20to%20my%20own%20social%20accounts%3A%20https%3A//github.com/matthewdonsemail-lab/log%0A%0ARead%20https%3A//github.com/matthewdonsemail-lab/log/blob/main/docs/trust.md%20first%2C%20then%20the%20README.%20Tell%20me%3A%20what%20it%20does%2C%20what%20it%20can%20send%20and%20when%20it%20needs%20my%20approval%2C%20where%20my%20sign-ins%20and%20messages%20are%20kept%2C%20what%20it%20will%20not%20do%2C%20and%20the%20risks%20for%20my%20accounts.%20Point%20to%20the%20file%20for%20each%20answer.) with the questions already written, or point your agent at [docs/trust.md](docs/trust.md) first: every control with how to check it.
|
|
43
|
+
|
|
44
|
+
**For reviewers:** every send command is a dry run by default. `log twitter dm --account <name> --userId <id> --text "hi"` prints what would be sent and stops; `log voice --to <handle> --text "<draft>"` shows the voice gate's score and its reasons. `bun test` runs the suite.
|
|
45
|
+
|
|
27
46
|
<table>
|
|
28
47
|
<tr>
|
|
29
48
|
<td width="50%" valign="middle">
|
|
@@ -98,7 +117,7 @@ log facebook join group --account <name> --group <url>
|
|
|
98
117
|
|
|
99
118
|
<p align="center">📖 <a href="https://log.listeningkit.com/docs"><b>Full documentation →</b></a></p>
|
|
100
119
|
|
|
101
|
-
log
|
|
120
|
+
log lets you, or your AI agent, read and reply to your own social accounts. It reads DMs, group chats, replies and notifications, drafts answers in your voice, and once you approve them sends messages, replies, likes, follows, reactions and voice notes. It's one command, `log`, and one MCP server, `logMcp`, and it runs on your own machine with your own accounts. Nothing acts until you say so: every command that changes something is a dry run until you add `--live`. It's free and open source.
|
|
102
121
|
|
|
103
122
|
## Quick start
|
|
104
123
|
|
|
@@ -114,17 +133,9 @@ This installs the `log` and `logMcp` commands, and Python with everything the pl
|
|
|
114
133
|
|
|
115
134
|
### Connect your accounts
|
|
116
135
|
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
| Platform | How to sign in |
|
|
120
|
-
|---|---|
|
|
121
|
-
| X | `log twitter cookies save --account <handle>`: paste `auth_token`, `ct0` and `twid` from a cookie-export extension |
|
|
122
|
-
| LinkedIn | `log linkedin cookies save --account <publicId>`: paste `li_at` and `JSESSIONID` |
|
|
123
|
-
| Slack | `log slack cookies save --account <name>`: paste the `d` cookie |
|
|
124
|
-
| Discord, Reddit, Instagram | `log localAccount add --platform <platform> --account <name>`, then `log inspect start --account <name>`, sign in by hand in the window that opens, and `log inspect do stop --account <name>` to save the session |
|
|
125
|
-
| Facebook | `log localAccount add --platform facebook --account <name>`, then `log facebook connect --account <name>` |
|
|
136
|
+
Sign each of your own accounts in once. X, LinkedIn and Slack take your existing session, typed into a masked prompt; Discord, Reddit and Instagram open a window where you sign in by hand; Facebook has its own connect step. Every step, per platform: [docs/accounts.md](docs/accounts.md).
|
|
126
137
|
|
|
127
|
-
Then check it with `log <platform> session check --account <name>`, which sends nothing. The answer is `loggedIn`, `loggedOut` or `restricted`.
|
|
138
|
+
Then check it with `log <platform> session check --account <name>`, which sends nothing. The answer is `loggedIn`, `loggedOut` or `restricted`.
|
|
128
139
|
|
|
129
140
|
### Connect your agent
|
|
130
141
|
|
|
@@ -145,7 +156,7 @@ Then ask in plain words: *"read my X DMs and tell me who's waiting on me"*. log'
|
|
|
145
156
|
| [Discord](docs/platformGuides/discord.md) | DMs, groups and server channels, live; sends, reactions, voice notes, files | its own API client and the live gateway, no browser |
|
|
146
157
|
| [Slack](docs/platformGuides/slack.md) | DMs and group DMs in every workspace, live; sends, reactions, voice notes | its own API client and the live socket, no browser |
|
|
147
158
|
| [Instagram](docs/platforms/instagram/README.md) | DM threads, live; sends, photos, reactions, voice notes | its own API client and the realtime connection, no browser |
|
|
148
|
-
| [Facebook](docs/platformGuides/facebook.md) | Marketplace listings, groups,
|
|
159
|
+
| [Facebook](docs/platformGuides/facebook.md) | Marketplace listings, groups, new-account setup | the account's own browser, opened once a day from the account's home country |
|
|
149
160
|
| [Reddit](docs/platformGuides/reddit.md) | session check (new) | its own API client |
|
|
150
161
|
| [LinkedIn](docs/platformGuides/linkedin.md) | session check (new) | its own API client |
|
|
151
162
|
|
|
@@ -158,7 +169,7 @@ Then ask in plain words: *"read my X DMs and tell me who's waiting on me"*. log'
|
|
|
158
169
|
- **What actually gets replies.** `log inbox outcomes` compares the reply rate of messages log sent with yours, matched by person and stage, and shows which plays work ([#246](https://github.com/matthewdonsemail-lab/log/pull/246)).
|
|
159
170
|
- **One session per account.** Each account keeps one connection open, the way the platform's own app does, never a new one per command.
|
|
160
171
|
- **Live inbox.** New messages are pushed into your agent's context as they arrive, and two agents never answer the same chat.
|
|
161
|
-
- **
|
|
172
|
+
- **Daily limits.** Every account has its own daily limits, pacing and quiet hours. A refusal from the platform stops the run, and nothing is retried.
|
|
162
173
|
- **A judge on every message in.** The voice gate checks what goes out; the judge checks what comes in. Token stealers, encoded scripts and prompt injection are held before your agent reads them, and a small local model marks what the rules miss ([#189](https://github.com/matthewdonsemail-lab/log/pull/189), [#190](https://github.com/matthewdonsemail-lab/log/pull/190)).
|
|
163
174
|
- **Turn aware.** On Discord and Slack a multi-line reply waits while they are typing, and holds the rest if they write back or keep typing ([#199](https://github.com/matthewdonsemail-lab/log/pull/199), [#202](https://github.com/matthewdonsemail-lab/log/pull/202)).
|
|
164
175
|
- **Search knows where it was said.** Every hit names a DM, a group or a server channel, and you can search only one of them ([#198](https://github.com/matthewdonsemail-lab/log/pull/198)).
|
|
@@ -431,45 +442,19 @@ A video with no sound, like motion graphics, says `no sound` and is told by what
|
|
|
431
442
|
|
|
432
443
|
### The models it uses
|
|
433
444
|
|
|
434
|
-
Five models run on your own machine, with no key. Four are
|
|
445
|
+
Five pinned models and two you train run on your own machine, with no key. Four hosted services are used only when you add their key. Each pin, how `log models` checks it, how models download and update, what your machine needs and how to turn each one off: [local models](docs/models.md).
|
|
435
446
|
|
|
436
447
|
| Model | Runs | What it does |
|
|
437
448
|
|---|---|---|
|
|
438
|
-
|
|
|
439
|
-
|
|
|
440
|
-
|
|
|
441
|
-
|
|
|
442
|
-
|
|
|
443
|
-
|
|
|
444
|
-
| Jina
|
|
445
|
-
| AssemblyAI | hosted, `ASSEMBLYAI_API_KEY` | what was said in a voice note or a video |
|
|
446
|
-
| Inworld or Fish Audio | hosted, `INWORLD_API_KEY` or `FISH_API_KEY` | a voice note in your cloned voice, only when you ask |
|
|
447
|
-
|
|
448
|
-
```mermaid
|
|
449
|
-
flowchart LR
|
|
450
|
-
IN["A message arrives"] --> DB[("log.db")]
|
|
451
|
-
IN -->|picture or video| VL["LFM2.5-VL, your machine"] --> DB
|
|
452
|
-
IN -->|voice| AA["AssemblyAI"] --> DB
|
|
453
|
-
DB --> ML["MiniLM, your machine"] --> IDX["search and voice indexes"]
|
|
454
|
-
DB --> WD["the judge: wolf-defender, your machine"] --> READ["your agent reads it"]
|
|
455
|
-
READ & IDX --> DRAFT["your agent drafts"] --> GATE["voice gate: SubQ and Jina"] --> SEND["sent as you"]
|
|
456
|
-
```
|
|
457
|
-
|
|
458
|
-
**What your machine needs,** measured here on 2026-11-09 (16 threads, CPU only):
|
|
459
|
-
- **A 64-bit machine.** There's no GPU: the local models run on the CPU.
|
|
460
|
-
- **About 2 GB of free memory.** The picture model peaked at 1.25 GB and takes 6 to 7 s a picture. It stops itself past 4 GB.
|
|
461
|
-
- **About 400 MB of disk** for MiniLM and the picture model, plus the judge's model, each downloaded the first time it's needed.
|
|
462
|
-
- **ffmpeg on your PATH** for videos and voice notes.
|
|
463
|
-
|
|
464
|
-
**Building the indexes** on a new machine, in this order:
|
|
465
|
-
1. `log search index` reads every conversation once and builds the keyword and meaning indexes.
|
|
466
|
-
2. `log voice index` builds your voice from what step 1 saved.
|
|
467
|
-
3. `log voice train` trains your AI-writing detector.
|
|
468
|
-
4. `log inbox label teach --apply`, then `log inbox label train`, labels your chats and trains the local labeller.
|
|
469
|
-
|
|
470
|
-
After that, new messages are added as they arrive, and pictures are described as they land.
|
|
449
|
+
| wolf-defender prompt injection small | your machine, pinned | the judge's model: scores prompt injection in what comes in |
|
|
450
|
+
| all-MiniLM-L6-v2 | your machine, pinned | meaning search, your voice index, matching what you typed to a play |
|
|
451
|
+
| roberta-base-go_emotions | your machine, pinned | the emotions of each new message, for your pipeline labels |
|
|
452
|
+
| LFM2.5-VL-450M | your machine, pinned | describes every picture and video frame as text |
|
|
453
|
+
| myuri | your machine, pinned pip package | human mouse paths, typing and scrolling in the browsers |
|
|
454
|
+
| your AI-writing detector and your pipeline labeller | your machine, trained on your data | the voice gate's AI reading; who each person is and where they are |
|
|
455
|
+
| SubQ, Jina, AssemblyAI, Inworld or Fish Audio | hosted, each with its key | the voice gate, ranking chat history, transcripts, voice notes ([what each receives](docs/trust.md#what-leaves-your-machine)) |
|
|
471
456
|
|
|
472
|
-
|
|
457
|
+
`log models` lists each pin with its size and says whether it is here and matches.
|
|
473
458
|
|
|
474
459
|
### Built on Designing Data-Intensive Applications
|
|
475
460
|
|
|
@@ -532,14 +517,14 @@ What's built, what's next and what's planned is kept in one pinned issue: **[Roa
|
|
|
532
517
|
|
|
533
518
|
| Area | Built | Next |
|
|
534
519
|
|---|---|---|
|
|
535
|
-
| Security | the judge's rules and local model | judging images, a guard before tool calls, taint, a canary token, an attack-set benchmark
|
|
520
|
+
| Security | the judge's rules and local model | judging images, a guard before tool calls, taint, a canary token, an attack-set benchmark |
|
|
536
521
|
| The record ([soron](docs/proposals/soron.md), [#197](https://github.com/matthewdonsemail-lab/log/issues/197)) | search by DM, group or channel | keeping edits and deletions, capturing the conversation around a personal mention (kept after a ban), judging each message the moment it arrives |
|
|
537
522
|
| Turn awareness ([spec](https://github.com/matthewdonsemail-lab/log/blob/turnAware/docs/proposals/turnAware.md)) | typing on Discord and Slack | X Chat |
|
|
538
523
|
| Tools | tool health | recording which tools the router offered, so unused tools can be told apart from unseen ones |
|
|
539
524
|
| Your day | the hottest deals in your DMs, from the pipeline labels | a morning debrief: who is waiting, what you owe, what was held overnight |
|
|
540
525
|
| Voice | cloned voice notes; the grounding pack and one calibrated score; an AI-writing detector trained on you | a higher catch rate on short messages, voice-note replies in your voice, then calls, with your yes per call |
|
|
541
526
|
| Pipeline ([#236](https://github.com/matthewdonsemail-lab/log/issues/236)) | who and where per chat on the CPU, the larger model when unsure, one person across platforms (suggested), reply outcomes | your own labels to measure the labeller against, the next step suggested per stage |
|
|
542
|
-
| Browser | human mouse: Fitts's-law timing, corrective moves, tremor ([#201](https://github.com/matthewdonsemail-lab/log/pull/201)) | sign-ins moving from AdsPower to Camoufox,
|
|
527
|
+
| Browser | human mouse: Fitts's-law timing, corrective moves, tremor ([#201](https://github.com/matthewdonsemail-lab/log/pull/201)) | sign-ins moving from AdsPower to Camoufox, HTTP for X and Discord that sends the same TLS handshake and headers as the account's own browser |
|
|
543
528
|
| Every harness ([spec](https://github.com/matthewdonsemail-lab/log/blob/genuiEverywhere/docs/proposals/genuiEverywhere.md), [#196](https://github.com/matthewdonsemail-lab/log/pull/196)) | views in Cursor, Claude and ChatGPT where the host draws MCP Apps | a ChatGPT connector, a smaller inbox tool profile, a Claude Desktop extension, a render test on every PR |
|
|
544
529
|
| Speed | hooks off the slow paths, one push loop per session, Discord catch-up in 4 calls, watchers that stay up | the prompt hook under 150 ms |
|
|
545
530
|
|
|
@@ -552,6 +537,7 @@ Newest first. Work merged into `main` collects in the open release PR, and mergi
|
|
|
552
537
|
<!-- releases:start: written by `bun run docs:releases` from CHANGELOG.md and src/models/manifest, not edited by hand -->
|
|
553
538
|
| Version | Date | What's in it | Models |
|
|
554
539
|
| --- | --- | --- | --- |
|
|
540
|
+
| [0.4.0](https://github.com/matthewdonsemail-lab/log/compare/v0.3.0...v0.4.0) | 2026-11-21 | agentWording keeps risk words out of what agents read; rules reworded (+9 more) | same as 0.3.0 |
|
|
555
541
|
| [0.3.0](https://github.com/matthewdonsemail-lab/log/pull/212) | 2026-11-20 | one live browser view for console and chat, hidden window when streamed (+41 more) | first pinned: wolf-defender-prompt-injection-small@2484cc9, all-MiniLM-L6-v2@751bff3, roberta-base-go_emotions-onnx@90ee0c1, LFM2.5-VL-450M-ONNX@24e6300, myuri@5.0.0 |
|
|
556
542
|
| [0.2.1](https://github.com/matthewdonsemail-lab/log/pull/179) | 2026-11-20 | The relate graph, the live inbox push (messages during tool calls, burst batching, late copies dropped), inbox labels and ignoring a server or chat (+2 more) | not pinned (newest by name) |
|
|
557
543
|
| [0.2.0](https://github.com/matthewdonsemail-lab/log/pull/166) | 2026-11-15 | The one-command Hermes pack, the catalog review, the README rewrite and the catch-up machine (+1 more) | not pinned (newest by name) |
|
package/docs/README.md
CHANGED
|
@@ -14,6 +14,10 @@ Then read [Using log well](usingLog.md).
|
|
|
14
14
|
|
|
15
15
|
[Use cases](useCases/README.md) are the jobs log is built for, step by step: replying to people on a topic, reading your DM inbox, listening to Facebook groups and more. Start here when you know what you want done.
|
|
16
16
|
|
|
17
|
+
## Research and decisions
|
|
18
|
+
|
|
19
|
+
Why log is built the way it is: every research note, test matrix and proposal is indexed in [research and decisions](decisions/README.md).
|
|
20
|
+
|
|
17
21
|
## Platforms
|
|
18
22
|
|
|
19
23
|
What you can do on each platform:
|
package/docs/accounts.md
CHANGED
|
@@ -27,7 +27,7 @@ X and LinkedIn accounts can skip this step: saving their cookies (below) adds th
|
|
|
27
27
|
|
|
28
28
|
## 2. Sign it in
|
|
29
29
|
|
|
30
|
-
### X and
|
|
30
|
+
### X, LinkedIn and Slack: paste your session
|
|
31
31
|
|
|
32
32
|
1. Open the site in a browser where the account is signed in.
|
|
33
33
|
2. Export its cookies with a cookie-export browser extension.
|
|
@@ -36,9 +36,10 @@ X and LinkedIn accounts can skip this step: saving their cookies (below) adds th
|
|
|
36
36
|
```bash
|
|
37
37
|
log twitter cookies save --account yourhandle
|
|
38
38
|
log linkedin cookies save --account your-public-id
|
|
39
|
+
log slack cookies save --account yourname
|
|
39
40
|
```
|
|
40
41
|
|
|
41
|
-
X asks for `auth_token`, `ct0` and `twid`. LinkedIn asks for `li_at` and `JSESSIONID`, and `--account` is the part after `linkedin.com/in/`. log checks the cookies with the platform before it saves them. They're never shown or passed as flags.
|
|
42
|
+
X asks for `auth_token`, `ct0` and `twid`. LinkedIn asks for `li_at` and `JSESSIONID`, and `--account` is the part after `linkedin.com/in/`. Slack asks for the `d` value. log checks the cookies with the platform before it saves them. They're never shown or passed as flags.
|
|
42
43
|
|
|
43
44
|
### Reddit and Discord: sign in once in the account's browser
|
|
44
45
|
|
|
@@ -71,3 +72,9 @@ Each platform has the same check: `log reddit session check`, `log discord sessi
|
|
|
71
72
|
To keep many accounts in one shared place instead of a local file, use [Twenty](twenty.md). `log localAccount pull` copies the accounts Twenty has into your local file, cookies and login included, each keeping its Twenty id (`--platform` for one platform; an account already in the file is kept unless `--refresh`). A local account wins over a Twenty account of the same name, and `LOG_ACCOUNTS=local` in `~/.logCli/.env` leaves Twenty out of accounts entirely. `LOG_LOCAL_ACCOUNTS` moves the file. Listings, groups and conversations stay in Twenty. The details: [Local accounts](specs/localAccounts.md).
|
|
72
73
|
|
|
73
74
|
Next: [connect your agent](mcp.md).
|
|
75
|
+
|
|
76
|
+
## Related
|
|
77
|
+
|
|
78
|
+
- Up: [log's README](../README.md)
|
|
79
|
+
- Start here, in order: [Install](install.md) · [Add an account](accounts.md) · [Connect your agent](mcp.md) · [What log does, and what it never does](trust.md)
|
|
80
|
+
- Then: [Use cases, the plays step by step](useCases/README.md) · [Your agent app](harnesses/README.md) · [What you can do on each platform](platformGuides/x.md) · [Every command and tool](reference.md) · [How log works](howItWorks.md)
|
package/docs/adsPower.md
CHANGED
|
@@ -118,3 +118,7 @@ Professional plan was $12 a month for 20 profiles, $21 for 50). You need one
|
|
|
118
118
|
profile per account that uses a browser, plus a couple for testing.
|
|
119
119
|
|
|
120
120
|
What the AdsPower code must do, requirement by requirement: [docs/specs/adsPower.md](specs/adsPower.md).
|
|
121
|
+
|
|
122
|
+
## Related
|
|
123
|
+
|
|
124
|
+
- Up: [How log works](howItWorks.md) · [log's README](../README.md)
|
package/docs/antigravityHooks.md
CHANGED
|
@@ -32,3 +32,7 @@ The adapter script `scripts/hooks/antigravity.ts` bridges Antigravity's JSON hoo
|
|
|
32
32
|
|
|
33
33
|
- **Workspace:** `.agents/hooks.json` in the workspace root.
|
|
34
34
|
- **Global:** `~/.gemini/config/hooks.json`.
|
|
35
|
+
|
|
36
|
+
## Related
|
|
37
|
+
|
|
38
|
+
- Up: [How log works](howItWorks.md) · [log's README](../README.md)
|
package/docs/browserIdentity.md
CHANGED
|
@@ -39,3 +39,7 @@ See [httpClients](httpClients/README.md): a live test against the real Chrome on
|
|
|
39
39
|
- curl_cffi 0.17 is needed for Windows Chrome targets. 0.16 targets all say macOS.
|
|
40
40
|
- 152 is the newest Chrome both libraries ship.
|
|
41
41
|
- httpcloak has no WebSocket client and no Python asyncio, which Discord, Slack and Facebook need.
|
|
42
|
+
|
|
43
|
+
## Related
|
|
44
|
+
|
|
45
|
+
- Up: [How log works](howItWorks.md) · [log's README](../README.md)
|
package/docs/browserSetup.md
CHANGED
package/docs/browsers.md
CHANGED
|
@@ -404,3 +404,7 @@ Errors are toasts. The console attaches to a browser that is already open (by
|
|
|
404
404
|
verifying a session from the console are not ported yet.
|
|
405
405
|
|
|
406
406
|
**In an MCP Apps host and in Hermes.** See [the live browser in the chat](mcp.md#the-live-browser-in-the-chat).
|
|
407
|
+
|
|
408
|
+
## Related
|
|
409
|
+
|
|
410
|
+
- Up: [How log works](howItWorks.md) · [log's README](../README.md)
|
package/docs/callTiming.md
CHANGED
|
@@ -62,3 +62,7 @@ The spans show which stage is slow. A profiler shows which function inside that
|
|
|
62
62
|
Never put a cookie, a token or message text in a name or an attribute.
|
|
63
63
|
|
|
64
64
|
Research: `RESEARCH/LOG_CLI_CALL_TRACING_TOOLING_2026_11_07.md` in the workspace. Spec: [callTiming](specs/callTiming.md).
|
|
65
|
+
|
|
66
|
+
## Related
|
|
67
|
+
|
|
68
|
+
- Up: [How log works](howItWorks.md) · [log's README](../README.md)
|
package/docs/commandNaming.md
CHANGED
|
@@ -100,3 +100,9 @@ What the runner refuses and what `bun run check:docs` checks are in the spec, [C
|
|
|
100
100
|
Code is laid out by platform first too, `src/<platform>/<area>/<domain>`, because each platform does things differently: for example `src/facebook/group/read` and `src/facebook/warmup/stages`. See [Where the code lives](layout.md).
|
|
101
101
|
|
|
102
102
|
The rules behind this are in AGENTS.md.
|
|
103
|
+
|
|
104
|
+
## Related
|
|
105
|
+
|
|
106
|
+
- Up: [log's README](../README.md)
|
|
107
|
+
- Start here, in order: [Install](install.md) · [Add an account](accounts.md) · [Connect your agent](mcp.md) · [What log does, and what it never does](trust.md)
|
|
108
|
+
- Then: [Use cases, the plays step by step](useCases/README.md) · [Your agent app](harnesses/README.md) · [What you can do on each platform](platformGuides/x.md) · [Every command and tool](reference.md) · [How log works](howItWorks.md)
|
package/docs/contextLayer.md
CHANGED
|
@@ -48,3 +48,7 @@ flowchart LR
|
|
|
48
48
|
## What moves next
|
|
49
49
|
|
|
50
50
|
On Claude Code this is done (issue #99): engines, inbox, queue, xLive, storage, pageState, knowledge and useCases all answer from the service, so a prompt or tool call costs one local http request. Measured on 2026-11-08: PostToolUse p50 8.0 ms, p99 12.2 ms, p99.9 14.3 ms (n=2000); UserPromptSubmit p50 9.6 ms, p99 15.0 ms, p99.9 17.4 ms (n=300). Before, four PostToolUse hooks through Git Bash took p50 472 ms and p99 1377 ms. A provider that reads the platform is changed to read the .db first (convention 6).
|
|
51
|
+
|
|
52
|
+
## Related
|
|
53
|
+
|
|
54
|
+
- Up: [How log works](howItWorks.md) · [log's README](../README.md)
|
package/docs/contributing.md
CHANGED
|
@@ -23,3 +23,11 @@ The workflow needs the repository secret `NPM_TOKEN`: an npm automation token wi
|
|
|
23
23
|
Installs hear about the release within a day through the update check; see [updates.md](updates.md).
|
|
24
24
|
|
|
25
25
|
Every merge to `main` whose `check` passed is also published as a nightly (`.github/workflows/nightly.yml`, npm dist-tag `next`, a GitHub prerelease); nobody runs it by hand either.
|
|
26
|
+
|
|
27
|
+
## Research
|
|
28
|
+
|
|
29
|
+
Research lives in the repo, not only in issue comments or a local folder. Each topic gets `docs/decisions/<topic>/research.md` (papers with their id and the one finding that matters), plus its test results and the decision. Add a row to [research and decisions](decisions/README.md) and link the page back to it. The issue comment can link the file instead of carrying the only copy.
|
|
30
|
+
|
|
31
|
+
## Related
|
|
32
|
+
|
|
33
|
+
- Up: [How log works](howItWorks.md) · [log's README](../README.md)
|
package/docs/conversations.md
CHANGED
|
@@ -89,3 +89,7 @@ Each command is also an MCP tool (`facebookConversations`, and `facebookConversa
|
|
|
89
89
|
- [#41](https://github.com/matthewdonsemail-lab/log/issues/41) reads the inbox from Facebook and replies to buyers. The scan is a browser launch like any other, with every launch gate, written from a `log inspect` recording of the Marketplace inbox first. A reply writes to Facebook, so it waits until the owner asks for it; its fields are in place already: `sentBy`, `aiStatus`, `aiOriginalText`, `autoReplied`, `aiTookOver`.
|
|
90
90
|
|
|
91
91
|
The rules behind this are in AGENTS.md.
|
|
92
|
+
|
|
93
|
+
## Related
|
|
94
|
+
|
|
95
|
+
- Up: [How log works](howItWorks.md) · [log's README](../README.md) · [What log does on Facebook](platformGuides/facebook.md)
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
# Research and decisions
|
|
2
|
+
|
|
3
|
+
Every research note, test matrix and proposal behind log's design, in one place. Each topic keeps its research, the options it scored and what was picked. Back to [docs](../README.md); the controls these led to are on the [trust page](../trust.md).
|
|
4
|
+
|
|
5
|
+
## Decisions
|
|
6
|
+
|
|
7
|
+
| Topic | Research | Other files |
|
|
8
|
+
|---|---|---|
|
|
9
|
+
| agentTrust | [Agent trust research (#255)](agentTrust/research.md) | [docsAudit](agentTrust/docsAudit.md), [judgeMatrix](agentTrust/judgeMatrix.md) |
|
|
10
|
+
| benchmarks | [Benchmarks for log: the right test for each area, from the research](benchmarks/research.md) | |
|
|
11
|
+
| encryptedStore | [Encrypted account store research (#258)](encryptedStore/research.md) | |
|
|
12
|
+
| genuiEverywhere | [Research: one generative-UI view in every harness, local and hosted](genuiEverywhere/research.md) | |
|
|
13
|
+
| mcpReload | [Research findings (Parallel and GitHub, 2026-11-07)](mcpReload/research.md) | [issue](mcpReload/issue.md), [readme_mcp-reloader](mcpReload/readme_mcp-reloader.md), [readme_mcpmon](mcpReload/readme_mcpmon.md), [readme_reloaderoo](mcpReload/readme_reloaderoo.md) |
|
|
14
|
+
| pipeline | [Research: labelling conversations, sales stages, and linking people](pipeline/research.md) | [issue](pipeline/issue.md), [proposal](pipeline/proposal.md), [results](pipeline/results.md) |
|
|
15
|
+
| processLimits | [Research: processes and IPC, from the fundamentals and measured on the owner's machine](processLimits/research.md) | [issue](processLimits/issue.md), [results](processLimits/results.md), [tools](processLimits/tools.md), [transcripts](processLimits/transcripts.md) |
|
|
16
|
+
| slopDetector | [Research: frontier-model writing conventions](slopDetector/research.md) | [issue](slopDetector/issue.md), [proposal](slopDetector/proposal.md), [repos](slopDetector/repos.md), [results](slopDetector/results.md) |
|
|
17
|
+
| voiceOptions | [Research: writing like one person from their own messages](voiceOptions/research.md) | [issue](voiceOptions/issue.md), [results](voiceOptions/results.md) |
|
|
18
|
+
|
|
19
|
+
## Proposals
|
|
20
|
+
|
|
21
|
+
- [One name and one input shape per capability](../proposals/capabilitySchema.md)
|
|
22
|
+
- [How context reaches the model: guides, router, hooks and harnesses](../proposals/contextInjectionAudit.md)
|
|
23
|
+
- [Conversation card: one short record per chat, read by the writer and the voice gate](../proposals/conversationCard.md)
|
|
24
|
+
- [Every file the proposals name](../proposals/fileIndex.md)
|
|
25
|
+
- [One view, every harness: log's generative UI in ChatGPT, Claude and local harnesses](../proposals/genuiEverywhere.md)
|
|
26
|
+
- [In-app verification (computer use) and generative-UI data storage](../proposals/inAppVerificationAndGenerativeUI.md)
|
|
27
|
+
- [Workspace data model: DDIA applied to the existing .logCli runtime](../proposals/listeningKitInstanceContracts.md)
|
|
28
|
+
- [Data boundary: hosted control service and workspace-local application database](../proposals/listeningKitNativeData.md)
|
|
29
|
+
- [Native Log schema and application contract](../proposals/listeningKitSchema.md)
|
|
30
|
+
- [Usage summaries](../proposals/listeningKitUsage.md)
|
|
31
|
+
- [People across platforms: one person, every identity, and the first-time interactor (issue #95)](../proposals/peopleAcrossPlatforms.md)
|
|
32
|
+
- [One platform-neutral capability set across the CLI, MCP and console](../proposals/platformNeutralSurfaces.md)
|
|
33
|
+
- [CLI and MCP parity: schemas, results and gates](../proposals/schemaParityAudit.md)
|
|
34
|
+
- [soron: capture the conversation around a personal mention, edits and deletions included](../proposals/soron.md)
|
|
35
|
+
- [Sources for the platform-neutral surfaces spec](../proposals/sources.md)
|
|
36
|
+
- [Turn awareness, tool health, the morning debrief and selling on calls](../proposals/turnAware.md)
|
|
37
|
+
- [Proposal: drafts grounded in the owner's own replies, one defined gate score, ranked options](../proposals/voiceOptions.md)
|
|
38
|
+
|
|
39
|
+
## Provider research
|
|
40
|
+
|
|
41
|
+
- [Persistent Cloud Browser Fleets: Costs, Constraints, and Shortlist](../providerResearch/agentVmHosts.md)
|
|
42
|
+
- [cloudBrowsersAndAntidetect.md](../providerResearch/cloudBrowsersAndAntidetect.md)
|
|
43
|
+
- [cloudPhonesAndDevices.md](../providerResearch/cloudPhonesAndDevices.md)
|
|
44
|
+
- [Residential Proxy Costs and Reliability for Persistent Accounts](../providerResearch/proxiesAndCaptcha.md)
|
|
45
|
+
- [References](../providerResearch/selfManagedCompute.md)
|
|
46
|
+
|
|
47
|
+
## Platform notes
|
|
48
|
+
|
|
49
|
+
Captured API notes for each platform live under [platforms](../platforms); agent-facing guides under [guides](../guides).
|