@shinobiapps/shinobi 0.1.5 → 0.2.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.
Files changed (36) hide show
  1. package/CHANGELOG.md +72 -0
  2. package/LICENSE +21 -21
  3. package/README.md +50 -17
  4. package/dist/cli.js +23 -1
  5. package/dist/cli.js.map +1 -1
  6. package/dist/dashboard/auth.d.ts.map +1 -1
  7. package/dist/dashboard/auth.js +6 -3
  8. package/dist/dashboard/auth.js.map +1 -1
  9. package/dist/dashboard/server.d.ts +10 -1
  10. package/dist/dashboard/server.d.ts.map +1 -1
  11. package/dist/dashboard/server.js +19 -2
  12. package/dist/dashboard/server.js.map +1 -1
  13. package/dist/dashboard-spa/assets/index-CUJDeC3Q.js +288 -0
  14. package/dist/dashboard-spa/assets/index-CUJDeC3Q.js.map +1 -0
  15. package/dist/dashboard-spa/assets/index-zCn4MV4E.css +1 -0
  16. package/dist/dashboard-spa/index.html +2 -2
  17. package/dist/lib/db.d.ts.map +1 -1
  18. package/dist/lib/db.js +6 -2
  19. package/dist/lib/db.js.map +1 -1
  20. package/dist/server/http.d.ts +17 -0
  21. package/dist/server/http.d.ts.map +1 -0
  22. package/dist/server/http.js +42 -0
  23. package/dist/server/http.js.map +1 -0
  24. package/dist/server/mcp.d.ts +14 -0
  25. package/dist/server/mcp.d.ts.map +1 -1
  26. package/dist/server/mcp.js +19 -1
  27. package/dist/server/mcp.js.map +1 -1
  28. package/docs/deploy-gcp-free.md +183 -0
  29. package/docs/getting-started.md +94 -0
  30. package/docs/remote-mcp.md +132 -0
  31. package/migrations/0001_initial_schema.sql +284 -284
  32. package/migrations/0002_activity_and_links.sql +26 -26
  33. package/package.json +10 -5
  34. package/dist/dashboard-spa/assets/index-BgInVUB2.js +0 -288
  35. package/dist/dashboard-spa/assets/index-BgInVUB2.js.map +0 -1
  36. package/dist/dashboard-spa/assets/index-h7KmljOs.css +0 -1
@@ -0,0 +1 @@
1
+ *,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:Consolas,Monaco,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}html{color-scheme:dark}body{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;font-family:-apple-system,BlinkMacSystemFont,Segoe UI,Helvetica,Arial,sans-serif}::-moz-selection{--tw-bg-opacity: 1;background-color:rgb(94 129 172 / var(--tw-bg-opacity, 1));--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}::selection{--tw-bg-opacity: 1;background-color:rgb(94 129 172 / var(--tw-bg-opacity, 1));--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.fixed{position:fixed}.relative{position:relative}.sticky{position:sticky}.inset-0{top:0;right:0;bottom:0;left:0}.inset-y-0{top:0;bottom:0}.bottom-0{bottom:0}.left-0{left:0}.right-0{right:0}.top-0{top:0}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.z-\[100\]{z-index:100}.-mx-8{margin-left:-2rem;margin-right:-2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-8{margin-top:2rem;margin-bottom:2rem}.-mb-px{margin-bottom:-1px}.mb-1{margin-bottom:.25rem}.mb-2{margin-bottom:.5rem}.mb-3{margin-bottom:.75rem}.mb-4{margin-bottom:1rem}.mb-6{margin-bottom:1.5rem}.mb-8{margin-bottom:2rem}.ml-1{margin-left:.25rem}.ml-2{margin-left:.5rem}.mr-0\.5{margin-right:.125rem}.mr-1{margin-right:.25rem}.mr-2{margin-right:.5rem}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-6{margin-top:1.5rem}.mt-8{margin-top:2rem}.block{display:block}.inline-block{display:inline-block}.inline{display:inline}.flex{display:flex}.table{display:table}.grid{display:grid}.contents{display:contents}.hidden{display:none}.h-1\.5{height:.375rem}.h-12{height:3rem}.h-3{height:.75rem}.h-3\.5{height:.875rem}.h-32{height:8rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-full{height:100%}.max-h-\[60vh\]{max-height:60vh}.min-h-\[200px\]{min-height:200px}.min-h-screen{min-height:100vh}.w-12{width:3rem}.w-20{width:5rem}.w-24{width:6rem}.w-28{width:7rem}.w-3{width:.75rem}.w-3\.5{width:.875rem}.w-32{width:8rem}.w-4{width:1rem}.w-40{width:10rem}.w-44{width:11rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-full{width:100%}.min-w-0{min-width:0px}.min-w-\[140px\]{min-width:140px}.max-w-2xl{max-width:42rem}.max-w-3xl{max-width:48rem}.max-w-4xl{max-width:56rem}.flex-1{flex:1 1 0%}.flex-shrink-0{flex-shrink:0}@keyframes pulse{50%{opacity:.5}}.animate-pulse{animation:pulse 2s cubic-bezier(.4,0,.6,1) infinite}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-pointer{cursor:pointer}.list-inside{list-style-position:inside}.list-decimal{list-style-type:decimal}.list-disc{list-style-type:disc}.grid-cols-1{grid-template-columns:repeat(1,minmax(0,1fr))}.grid-cols-2{grid-template-columns:repeat(2,minmax(0,1fr))}.grid-cols-3{grid-template-columns:repeat(3,minmax(0,1fr))}.grid-cols-\[10rem_1fr\]{grid-template-columns:10rem 1fr}.grid-cols-\[110px_160px_1fr\]{grid-template-columns:110px 160px 1fr}.grid-cols-\[110px_160px_1fr_140px\]{grid-template-columns:110px 160px 1fr 140px}.grid-cols-\[12rem_1fr\]{grid-template-columns:12rem 1fr}.grid-cols-\[8rem_1fr\]{grid-template-columns:8rem 1fr}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-start{align-items:flex-start}.items-center{align-items:center}.items-baseline{align-items:baseline}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-0\.5{gap:.125rem}.gap-1{gap:.25rem}.gap-1\.5{gap:.375rem}.gap-2{gap:.5rem}.gap-3{gap:.75rem}.gap-4{gap:1rem}.gap-x-4{-moz-column-gap:1rem;column-gap:1rem}.gap-y-1{row-gap:.25rem}.gap-y-1\.5{row-gap:.375rem}.gap-y-2{row-gap:.5rem}.space-y-1>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(.25rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(.25rem * var(--tw-space-y-reverse))}.space-y-1\.5>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(.375rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(.375rem * var(--tw-space-y-reverse))}.space-y-2>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(.5rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(.5rem * var(--tw-space-y-reverse))}.space-y-3>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(.75rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(.75rem * var(--tw-space-y-reverse))}.space-y-5>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1.25rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1.25rem * var(--tw-space-y-reverse))}.space-y-6>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1.5rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1.5rem * var(--tw-space-y-reverse))}.space-y-px>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1px * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1px * var(--tw-space-y-reverse))}.overflow-hidden{overflow:hidden}.overflow-x-auto{overflow-x:auto}.overflow-y-auto{overflow-y:auto}.truncate{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.whitespace-nowrap{white-space:nowrap}.whitespace-pre-wrap{white-space:pre-wrap}.break-words{overflow-wrap:break-word}.break-all{word-break:break-all}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border{border-width:1px}.border-b{border-bottom-width:1px}.border-b-2{border-bottom-width:2px}.border-l{border-left-width:1px}.border-l-2{border-left-width:2px}.border-l-4{border-left-width:4px}.border-r{border-right-width:1px}.border-t{border-top-width:1px}.border-dashed{border-style:dashed}.border-accent{--tw-border-opacity: 1;border-color:rgb(136 192 208 / var(--tw-border-opacity, 1))}.border-accent-2{--tw-border-opacity: 1;border-color:rgb(94 129 172 / var(--tw-border-opacity, 1))}.border-border{--tw-border-opacity: 1;border-color:rgb(42 49 60 / var(--tw-border-opacity, 1))}.border-border\/40{border-color:#2a313c66}.border-danger{--tw-border-opacity: 1;border-color:rgb(191 97 106 / var(--tw-border-opacity, 1))}.border-danger\/40{border-color:#bf616a66}.border-success\/40{border-color:#a3be8c66}.border-transparent{border-color:transparent}.border-warning\/40{border-color:#ebcb8b66}.border-l-accent{--tw-border-opacity: 1;border-left-color:rgb(136 192 208 / var(--tw-border-opacity, 1))}.border-l-warning{--tw-border-opacity: 1;border-left-color:rgb(235 203 139 / var(--tw-border-opacity, 1))}.bg-accent{--tw-bg-opacity: 1;background-color:rgb(136 192 208 / var(--tw-bg-opacity, 1))}.bg-accent-2{--tw-bg-opacity: 1;background-color:rgb(94 129 172 / var(--tw-bg-opacity, 1))}.bg-accent\/20{background-color:#88c0d033}.bg-accent\/30{background-color:#88c0d04d}.bg-amber-500{--tw-bg-opacity: 1;background-color:rgb(245 158 11 / var(--tw-bg-opacity, 1))}.bg-bg{--tw-bg-opacity: 1;background-color:rgb(15 18 22 / var(--tw-bg-opacity, 1))}.bg-bg\/95{background-color:#0f1216f2}.bg-black\/50{background-color:#00000080}.bg-black\/60{background-color:#0009}.bg-border{--tw-bg-opacity: 1;background-color:rgb(42 49 60 / var(--tw-bg-opacity, 1))}.bg-border-2{--tw-bg-opacity: 1;background-color:rgb(59 66 82 / var(--tw-bg-opacity, 1))}.bg-border\/40{background-color:#2a313c66}.bg-danger{--tw-bg-opacity: 1;background-color:rgb(191 97 106 / var(--tw-bg-opacity, 1))}.bg-danger\/20{background-color:#bf616a33}.bg-emerald-500{--tw-bg-opacity: 1;background-color:rgb(16 185 129 / var(--tw-bg-opacity, 1))}.bg-orange{--tw-bg-opacity: 1;background-color:rgb(208 135 112 / var(--tw-bg-opacity, 1))}.bg-panel{--tw-bg-opacity: 1;background-color:rgb(22 27 34 / var(--tw-bg-opacity, 1))}.bg-panel-2{--tw-bg-opacity: 1;background-color:rgb(26 31 38 / var(--tw-bg-opacity, 1))}.bg-success{--tw-bg-opacity: 1;background-color:rgb(163 190 140 / var(--tw-bg-opacity, 1))}.bg-success\/20{background-color:#a3be8c33}.bg-text-dim{--tw-bg-opacity: 1;background-color:rgb(76 86 106 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-warning{--tw-bg-opacity: 1;background-color:rgb(235 203 139 / var(--tw-bg-opacity, 1))}.bg-warning\/20{background-color:#ebcb8b33}.bg-warning\/30{background-color:#ebcb8b4d}.bg-ws-shinobi{--tw-bg-opacity: 1;background-color:rgb(94 129 172 / var(--tw-bg-opacity, 1))}.bg-ws-shinobiapps{--tw-bg-opacity: 1;background-color:rgb(163 190 140 / var(--tw-bg-opacity, 1))}.bg-ws-sitesnap{--tw-bg-opacity: 1;background-color:rgb(208 135 112 / var(--tw-bg-opacity, 1))}.p-2\.5{padding:.625rem}.p-3{padding:.75rem}.p-4{padding:1rem}.p-5{padding:1.25rem}.p-6{padding:1.5rem}.px-1{padding-left:.25rem;padding-right:.25rem}.px-1\.5{padding-left:.375rem;padding-right:.375rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-3\.5{padding-left:.875rem;padding-right:.875rem}.px-4{padding-left:1rem;padding-right:1rem}.px-5{padding-left:1.25rem;padding-right:1.25rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0\.5{padding-top:.125rem;padding-bottom:.125rem}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-1\.5{padding-top:.375rem;padding-bottom:.375rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-6{padding-top:1.5rem;padding-bottom:1.5rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-5{padding-left:1.25rem}.pr-3{padding-right:.75rem}.pt-20{padding-top:5rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.align-top{vertical-align:top}.font-mono{font-family:Consolas,Monaco,monospace}.text-2xl{font-size:1.5rem;line-height:2rem}.text-6xl{font-size:3.75rem;line-height:1}.text-\[10px\]{font-size:10px}.text-\[11px\]{font-size:11px}.text-\[9px\]{font-size:9px}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.text-xl{font-size:1.25rem;line-height:1.75rem}.text-xs{font-size:.75rem;line-height:1rem}.font-bold{font-weight:700}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.lowercase{text-transform:lowercase}.normal-case{text-transform:none}.italic{font-style:italic}.tabular-nums{--tw-numeric-spacing: tabular-nums;font-variant-numeric:var(--tw-ordinal) var(--tw-slashed-zero) var(--tw-numeric-figure) var(--tw-numeric-spacing) var(--tw-numeric-fraction)}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-wider{letter-spacing:.05em}.text-accent{--tw-text-opacity: 1;color:rgb(136 192 208 / var(--tw-text-opacity, 1))}.text-bg{--tw-text-opacity: 1;color:rgb(15 18 22 / var(--tw-text-opacity, 1))}.text-danger{--tw-text-opacity: 1;color:rgb(191 97 106 / var(--tw-text-opacity, 1))}.text-success{--tw-text-opacity: 1;color:rgb(163 190 140 / var(--tw-text-opacity, 1))}.text-text{--tw-text-opacity: 1;color:rgb(216 222 233 / var(--tw-text-opacity, 1))}.text-text-dim{--tw-text-opacity: 1;color:rgb(76 86 106 / var(--tw-text-opacity, 1))}.text-text-muted{--tw-text-opacity: 1;color:rgb(107 119 133 / var(--tw-text-opacity, 1))}.text-warning{--tw-text-opacity: 1;color:rgb(235 203 139 / var(--tw-text-opacity, 1))}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.underline{text-decoration-line:underline}.opacity-60{opacity:.6}.shadow-2xl{--tw-shadow: 0 25px 50px -12px rgb(0 0 0 / .25);--tw-shadow-colored: 0 25px 50px -12px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.outline-none{outline:2px solid transparent;outline-offset:2px}.filter{filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.backdrop-blur{--tw-backdrop-blur: blur(8px);-webkit-backdrop-filter:var(--tw-backdrop-blur) var(--tw-backdrop-brightness) var(--tw-backdrop-contrast) var(--tw-backdrop-grayscale) var(--tw-backdrop-hue-rotate) var(--tw-backdrop-invert) var(--tw-backdrop-opacity) var(--tw-backdrop-saturate) var(--tw-backdrop-sepia);backdrop-filter:var(--tw-backdrop-blur) var(--tw-backdrop-brightness) var(--tw-backdrop-contrast) var(--tw-backdrop-grayscale) var(--tw-backdrop-hue-rotate) var(--tw-backdrop-invert) var(--tw-backdrop-opacity) var(--tw-backdrop-saturate) var(--tw-backdrop-sepia)}.backdrop-blur-sm{--tw-backdrop-blur: blur(4px);-webkit-backdrop-filter:var(--tw-backdrop-blur) var(--tw-backdrop-brightness) var(--tw-backdrop-contrast) var(--tw-backdrop-grayscale) var(--tw-backdrop-hue-rotate) var(--tw-backdrop-invert) var(--tw-backdrop-opacity) var(--tw-backdrop-saturate) var(--tw-backdrop-sepia);backdrop-filter:var(--tw-backdrop-blur) var(--tw-backdrop-brightness) var(--tw-backdrop-contrast) var(--tw-backdrop-grayscale) var(--tw-backdrop-hue-rotate) var(--tw-backdrop-invert) var(--tw-backdrop-opacity) var(--tw-backdrop-saturate) var(--tw-backdrop-sepia)}.transition{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke,opacity,box-shadow,transform,filter,backdrop-filter;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.scrollbar-thin{scrollbar-width:thin;scrollbar-color:#3b4252 transparent}.scrollbar-thin::-webkit-scrollbar{width:6px;height:6px}.scrollbar-thin::-webkit-scrollbar-thumb{background:#3b4252;border-radius:3px}.file\:mr-3::file-selector-button{margin-right:.75rem}.file\:cursor-pointer::file-selector-button{cursor:pointer}.file\:rounded::file-selector-button{border-radius:.25rem}.file\:border-0::file-selector-button{border-width:0px}.file\:bg-accent::file-selector-button{--tw-bg-opacity: 1;background-color:rgb(136 192 208 / var(--tw-bg-opacity, 1))}.file\:px-3::file-selector-button{padding-left:.75rem;padding-right:.75rem}.file\:py-1\.5::file-selector-button{padding-top:.375rem;padding-bottom:.375rem}.file\:text-bg::file-selector-button{--tw-text-opacity: 1;color:rgb(15 18 22 / var(--tw-text-opacity, 1))}.placeholder\:text-text-dim::-moz-placeholder{--tw-text-opacity: 1;color:rgb(76 86 106 / var(--tw-text-opacity, 1))}.placeholder\:text-text-dim::placeholder{--tw-text-opacity: 1;color:rgb(76 86 106 / var(--tw-text-opacity, 1))}.hover\:border-accent\/60:hover{border-color:#88c0d099}.hover\:border-border-2:hover{--tw-border-opacity: 1;border-color:rgb(59 66 82 / var(--tw-border-opacity, 1))}.hover\:bg-accent-3:hover{--tw-bg-opacity: 1;background-color:rgb(129 161 193 / var(--tw-bg-opacity, 1))}.hover\:bg-border:hover{--tw-bg-opacity: 1;background-color:rgb(42 49 60 / var(--tw-bg-opacity, 1))}.hover\:bg-panel:hover{--tw-bg-opacity: 1;background-color:rgb(22 27 34 / var(--tw-bg-opacity, 1))}.hover\:bg-panel-2\/60:hover{background-color:#1a1f2699}.hover\:bg-panel\/40:hover{background-color:#161b2266}.hover\:text-accent:hover{--tw-text-opacity: 1;color:rgb(136 192 208 / var(--tw-text-opacity, 1))}.hover\:text-text:hover{--tw-text-opacity: 1;color:rgb(216 222 233 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-90:hover{opacity:.9}.focus\:border-accent:focus{--tw-border-opacity: 1;border-color:rgb(136 192 208 / var(--tw-border-opacity, 1))}.focus\:outline-none:focus{outline:2px solid transparent;outline-offset:2px}.disabled\:cursor-wait:disabled{cursor:wait}.disabled\:text-text-dim:disabled{--tw-text-opacity: 1;color:rgb(76 86 106 / var(--tw-text-opacity, 1))}.disabled\:opacity-50:disabled{opacity:.5}@media (min-width: 640px){.sm\:w-\[480px\]{width:480px}}@media (min-width: 768px){.md\:block{display:block}.md\:hidden{display:none}.md\:grid-cols-3{grid-template-columns:repeat(3,minmax(0,1fr))}.md\:grid-cols-4{grid-template-columns:repeat(4,minmax(0,1fr))}.md\:p-8{padding:2rem}}
@@ -13,8 +13,8 @@
13
13
  <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent" />
14
14
  <meta name="apple-mobile-web-app-title" content="Shinobi" />
15
15
  <title>Shinobi</title>
16
- <script type="module" crossorigin src="/assets/index-BgInVUB2.js"></script>
17
- <link rel="stylesheet" crossorigin href="/assets/index-h7KmljOs.css">
16
+ <script type="module" crossorigin src="/assets/index-CUJDeC3Q.js"></script>
17
+ <link rel="stylesheet" crossorigin href="/assets/index-zCn4MV4E.css">
18
18
  </head>
19
19
  <body class="bg-bg text-text">
20
20
  <div id="root"></div>
@@ -1 +1 @@
1
- {"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/lib/db.ts"],"names":[],"mappings":"AAAA,OAAiB,EAAE,KAAK,QAAQ,IAAI,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAOtE,wBAAgB,SAAS,IAAI,MAAM,CAMlC;AAED,wBAAgB,KAAK,IAAI,SAAS,CAejC;AAED,wBAAgB,OAAO,IAAI,IAAI,CAK9B"}
1
+ {"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/lib/db.ts"],"names":[],"mappings":"AAAA,OAAiB,EAAE,KAAK,QAAQ,IAAI,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAQtE,wBAAgB,SAAS,IAAI,MAAM,CAUlC;AAED,wBAAgB,KAAK,IAAI,SAAS,CAejC;AAED,wBAAgB,OAAO,IAAI,IAAI,CAK9B"}
package/dist/lib/db.js CHANGED
@@ -1,14 +1,18 @@
1
1
  import Database from 'better-sqlite3';
2
2
  import { mkdirSync } from 'node:fs';
3
- import { homedir } from 'node:os';
4
3
  import { dirname, resolve } from 'node:path';
4
+ import { configDir } from './config.js';
5
5
  let cached = null;
6
6
  export function getDbPath() {
7
7
  const override = process.env['SHINOBI_DB_PATH'];
8
8
  if (override && override.length > 0) {
9
9
  return override;
10
10
  }
11
- return resolve(homedir(), '.shinobi', 'shinobi.db');
11
+ // Lives under configDir() so SHINOBI_CONFIG_DIR relocates the database
12
+ // together with config.json / dashboard-token (critical for Docker, where
13
+ // /data is the persistent volume). Default resolves to ~/.shinobi/shinobi.db,
14
+ // identical to the previous hardcoded path.
15
+ return resolve(configDir(), 'shinobi.db');
12
16
  }
13
17
  export function getDb() {
14
18
  if (cached) {
@@ -1 +1 @@
1
- {"version":3,"file":"db.js","sourceRoot":"","sources":["../../src/lib/db.ts"],"names":[],"mappings":"AAAA,OAAO,QAAwC,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE7C,IAAI,MAAM,GAAqB,IAAI,CAAC;AAEpC,MAAM,UAAU,SAAS;IACvB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAChD,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpC,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,OAAO,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,KAAK;IACnB,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,IAAI,GAAG,SAAS,EAAE,CAAC;IACzB,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE9C,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9B,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAChC,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAC/B,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC;IAClC,EAAE,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;IAEjC,MAAM,GAAG,EAAE,CAAC;IACZ,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,OAAO;IACrB,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,MAAM,GAAG,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}
1
+ {"version":3,"file":"db.js","sourceRoot":"","sources":["../../src/lib/db.ts"],"names":[],"mappings":"AAAA,OAAO,QAAwC,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,IAAI,MAAM,GAAqB,IAAI,CAAC;AAEpC,MAAM,UAAU,SAAS;IACvB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAChD,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpC,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,uEAAuE;IACvE,0EAA0E;IAC1E,8EAA8E;IAC9E,4CAA4C;IAC5C,OAAO,OAAO,CAAC,SAAS,EAAE,EAAE,YAAY,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,KAAK;IACnB,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,IAAI,GAAG,SAAS,EAAE,CAAC;IACzB,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE9C,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9B,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAChC,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAC/B,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC;IAClC,EAAE,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;IAEjC,MAAM,GAAG,EAAE,CAAC;IACZ,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,OAAO;IACrB,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,MAAM,GAAG,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}
@@ -0,0 +1,17 @@
1
+ import type { Hono } from 'hono';
2
+ import { type ServerInfo } from './mcp.js';
3
+ /**
4
+ * Mounts the MCP streamable HTTP endpoint at /mcp on an existing Hono app.
5
+ *
6
+ * Stateless mode: each POST gets a fresh Server + transport pair over the
7
+ * shared tool registry, so requests carry no session affinity and the
8
+ * endpoint works behind load balancers and across dashboard restarts.
9
+ * Callers must run initToolRuntime() once before the first request comes in
10
+ * (startDashboard does this when the endpoint is enabled).
11
+ *
12
+ * Auth note: routes registered here sit behind the dashboard-wide auth
13
+ * middleware when it is enabled. MCP clients authenticate with
14
+ * `Authorization: Bearer <token>` — the same token the dashboard uses.
15
+ */
16
+ export declare function registerMcpRoutes(app: Hono, info?: ServerInfo): void;
17
+ //# sourceMappingURL=http.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/server/http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAIjC,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3D;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,CA8BpE"}
@@ -0,0 +1,42 @@
1
+ import { WebStandardStreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js';
2
+ import { buildMcpServer } from './mcp.js';
3
+ /**
4
+ * Mounts the MCP streamable HTTP endpoint at /mcp on an existing Hono app.
5
+ *
6
+ * Stateless mode: each POST gets a fresh Server + transport pair over the
7
+ * shared tool registry, so requests carry no session affinity and the
8
+ * endpoint works behind load balancers and across dashboard restarts.
9
+ * Callers must run initToolRuntime() once before the first request comes in
10
+ * (startDashboard does this when the endpoint is enabled).
11
+ *
12
+ * Auth note: routes registered here sit behind the dashboard-wide auth
13
+ * middleware when it is enabled. MCP clients authenticate with
14
+ * `Authorization: Bearer <token>` — the same token the dashboard uses.
15
+ */
16
+ export function registerMcpRoutes(app, info) {
17
+ app.post('/mcp', async (c) => {
18
+ const server = buildMcpServer(info);
19
+ const transport = new WebStandardStreamableHTTPServerTransport({
20
+ // No sessionIdGenerator → stateless mode.
21
+ enableJsonResponse: true,
22
+ });
23
+ await server.connect(transport);
24
+ try {
25
+ return await transport.handleRequest(c.req.raw);
26
+ }
27
+ finally {
28
+ // JSON-response mode buffers the body before resolving, so closing
29
+ // here cannot cancel an in-flight stream.
30
+ void transport.close();
31
+ void server.close();
32
+ }
33
+ });
34
+ // Stateless server: there is no SSE stream to resume and no session to
35
+ // delete. Respond with a JSON-RPC error per the streamable HTTP spec.
36
+ app.on(['GET', 'DELETE'], '/mcp', (c) => c.json({
37
+ jsonrpc: '2.0',
38
+ error: { code: -32000, message: 'Method not allowed: stateless endpoint, use POST' },
39
+ id: null,
40
+ }, 405));
41
+ }
42
+ //# sourceMappingURL=http.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/server/http.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,wCAAwC,EAAE,MAAM,+DAA+D,CAAC;AAEzH,OAAO,EAAE,cAAc,EAAmB,MAAM,UAAU,CAAC;AAE3D;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAS,EAAE,IAAiB;IAC5D,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QAC3B,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM,SAAS,GAAG,IAAI,wCAAwC,CAAC;YAC7D,0CAA0C;YAC1C,kBAAkB,EAAE,IAAI;SACzB,CAAC,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAChC,IAAI,CAAC;YACH,OAAO,MAAM,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClD,CAAC;gBAAS,CAAC;YACT,mEAAmE;YACnE,0CAA0C;YAC1C,KAAK,SAAS,CAAC,KAAK,EAAE,CAAC;YACvB,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC;QACtB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,uEAAuE;IACvE,sEAAsE;IACtE,GAAG,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CACtC,CAAC,CAAC,IAAI,CACJ;QACE,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,kDAAkD,EAAE;QACpF,EAAE,EAAE,IAAI;KACT,EACD,GAAG,CACJ,CACF,CAAC;AACJ,CAAC"}
@@ -1,6 +1,20 @@
1
+ import { Server } from '@modelcontextprotocol/sdk/server/index.js';
1
2
  export interface ServerInfo {
2
3
  name: string;
3
4
  version: string;
4
5
  }
6
+ /**
7
+ * One-time runtime bootstrap shared by every transport (stdio + HTTP):
8
+ * migrations, built-in tool registration, plugin discovery. Safe to call
9
+ * more than once — registerBuiltins guards itself and migrations are
10
+ * checksum-gated.
11
+ */
12
+ export declare function initToolRuntime(): Promise<void>;
13
+ /**
14
+ * Builds a configured MCP Server wired to the shared tool registry.
15
+ * Transport-agnostic: callers connect it to stdio (startMcpServer) or to a
16
+ * per-request streamable HTTP transport (server/http.ts).
17
+ */
18
+ export declare function buildMcpServer(info?: ServerInfo): Server;
5
19
  export declare function startMcpServer(info?: ServerInfo): Promise<void>;
6
20
  //# sourceMappingURL=mcp.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/server/mcp.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAID,wBAAsB,cAAc,CAAC,IAAI,GAAE,UAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgDnF"}
1
+ {"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/server/mcp.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAYnE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAID;;;;;GAKG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAIrD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,GAAE,UAAyB,GAAG,MAAM,CA0CtE;AAED,wBAAsB,cAAc,CAAC,IAAI,GAAE,UAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAMnF"}
@@ -9,10 +9,23 @@ import { loadDiscoveredPlugins } from '../services/plugins/registry.js';
9
9
  import { allTools, getTool, registerBuiltins } from './tools/index.js';
10
10
  import { trackEvent } from '../services/telemetry/client.js';
11
11
  const DEFAULT_INFO = { name: 'shinobi', version: '0.0.1' };
12
- export async function startMcpServer(info = DEFAULT_INFO) {
12
+ /**
13
+ * One-time runtime bootstrap shared by every transport (stdio + HTTP):
14
+ * migrations, built-in tool registration, plugin discovery. Safe to call
15
+ * more than once — registerBuiltins guards itself and migrations are
16
+ * checksum-gated.
17
+ */
18
+ export async function initToolRuntime() {
13
19
  applyPendingMigrations();
14
20
  registerBuiltins();
15
21
  await loadDiscoveredPlugins();
22
+ }
23
+ /**
24
+ * Builds a configured MCP Server wired to the shared tool registry.
25
+ * Transport-agnostic: callers connect it to stdio (startMcpServer) or to a
26
+ * per-request streamable HTTP transport (server/http.ts).
27
+ */
28
+ export function buildMcpServer(info = DEFAULT_INFO) {
16
29
  const server = new Server(info, { capabilities: { tools: {} } });
17
30
  server.setRequestHandler(ListToolsRequestSchema, async () => ({
18
31
  tools: allTools().map((tool) => ({
@@ -48,6 +61,11 @@ export async function startMcpServer(info = DEFAULT_INFO) {
48
61
  };
49
62
  }
50
63
  });
64
+ return server;
65
+ }
66
+ export async function startMcpServer(info = DEFAULT_INFO) {
67
+ await initToolRuntime();
68
+ const server = buildMcpServer(info);
51
69
  const transport = new StdioServerTransport();
52
70
  await server.connect(transport);
53
71
  stderr.write(`shinobi mcp: server ready (${allTools().length} tools)\n`);
@@ -1 +1 @@
1
- {"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/server/mcp.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/server/mcp.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,183 @@
1
+ # Deploy Shinobi for $0/month: GCP free tier + Cloudflare Tunnel
2
+
3
+ End-to-end walkthrough for hosting your Shinobi brain on Google Cloud's
4
+ Always Free e2-micro VM, published over HTTPS with a free Cloudflare Tunnel —
5
+ no open ports, no static IP, no monthly bill. ~45 minutes.
6
+
7
+ This is the battle-tested version of [remote mode](remote-mcp.md): every
8
+ gotcha below was hit for real. Read the callouts.
9
+
10
+ ## What you need
11
+
12
+ - Google account with billing enabled (card on file; the bill stays $0)
13
+ - Cloudflare account with your domain's DNS on Cloudflare (any plan, Free works)
14
+
15
+ ## 1. Create the VM (GCP console)
16
+
17
+ [console.cloud.google.com](https://console.cloud.google.com) → Compute Engine
18
+ → VM instances → **Create instance**:
19
+
20
+ | Setting | Value |
21
+ | --- | --- |
22
+ | Name | `shinobi` |
23
+ | Region | **us-central1, us-east1 or us-west1 only** — free tier is limited to these three |
24
+ | Machine type | General purpose → E2 → **Shared-core → e2-micro** |
25
+ | Boot disk | Debian 12, **30 GB**, type **Standard persistent disk** |
26
+ | Snapshot schedule | **None** — remove `default-schedule-1` if pre-attached |
27
+
28
+ > ⚠️ **The console defaults are NOT free.** It pre-selects e2-medium
29
+ > (~$25/mo), a 10 GB *Balanced* disk (charged), and sometimes attaches a
30
+ > snapshot schedule (charged). Change all three.
31
+ >
32
+ > ⚠️ **The estimate will still show ~$6/mo for e2-micro.** That's expected:
33
+ > the estimator doesn't know about the Always Free tier. The discount is
34
+ > applied on the invoice (Billing → Reports shows the charge and the
35
+ > offsetting credit). Verify after a few days.
36
+
37
+ Create, wait for the green check, then open the browser **SSH** button.
38
+
39
+ ## 2. Swap, Docker, build (VM via SSH)
40
+
41
+ The 1 GB e2-micro cannot build Shinobi without swap — add it first:
42
+
43
+ ```bash
44
+ sudo fallocate -l 2G /swapfile && sudo chmod 600 /swapfile && sudo mkswap /swapfile && sudo swapon /swapfile
45
+ echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
46
+ ```
47
+
48
+ Docker + clone + build:
49
+
50
+ ```bash
51
+ sudo apt update && sudo apt install -y docker.io git
52
+ sudo usermod -aG docker $USER
53
+ exit # reopen SSH so the docker group applies
54
+
55
+ git clone https://github.com/numbererikson/shinobi && cd shinobi
56
+ docker build -t shinobi .
57
+ ```
58
+
59
+ > ⏳ The build takes 10–15 minutes on e2-micro and looks frozen during the
60
+ > TypeScript/Vite steps. It isn't. Wait for `Successfully tagged shinobi:latest`.
61
+
62
+ ## 3. Run it
63
+
64
+ ```bash
65
+ TOKEN=$(openssl rand -hex 24) && echo "SAVE THIS: $TOKEN"
66
+ docker run -d --name shinobi --restart unless-stopped \
67
+ -p 127.0.0.1:8765:8765 \
68
+ -v shinobi-data:/data \
69
+ -e SHINOBI_DASHBOARD_TOKEN=$TOKEN \
70
+ shinobi
71
+
72
+ curl http://127.0.0.1:8765/health # → {"ok":true,...}
73
+ ```
74
+
75
+ Save the token in your password manager — every client authenticates with it.
76
+
77
+ The `-v shinobi-data:/data` volume holds the SQLite database
78
+ (`/data/shinobi.db`); without it, replacing the container wipes your memory.
79
+
80
+ ## 4. Cloudflare Tunnel
81
+
82
+ Cloudflare dashboard → **Zero Trust** (first time: pick the **Free** plan;
83
+ it asks for a card for anti-abuse verification — the plan bills $0 and
84
+ tunnels have no usage charges).
85
+
86
+ 1. **Networks → Connectors** (a.k.a. Tunnels) → **Create a tunnel** →
87
+ type **Cloudflared** → name `shinobi` → Save.
88
+ 2. On "Install and run a connector": switch the OS dropdown to
89
+ **Debian / 64-bit** (it defaults to Windows!) and run the **two** shown
90
+ blocks in the VM's SSH — first installs `cloudflared` via apt, second
91
+ (`sudo cloudflared service install eyJ...`) registers it as a systemd
92
+ service. Skip the third "run manually" variant.
93
+ 3. Wait for the connector to show **Connected**, then add the route — tab
94
+ **Published application routes** → Add:
95
+ - Subdomain: `shinobi`, Domain: your zone → `shinobi.yourdomain.com`
96
+ - Service: Type **HTTP**, URL **`localhost:8765`** (the full value, not
97
+ just the port)
98
+
99
+ > ⚠️ If the browser later says `ERR_NAME_NOT_RESOLVED`, the route didn't
100
+ > save — the tunnel list will show `Routes: --`. Re-add the published
101
+ > application route. Also make sure the domain you picked shows **Active**
102
+ > (not "Pending Nameserver Update") under Cloudflare → Websites.
103
+
104
+ Test from any device: `https://shinobi.yourdomain.com/health` → `{"ok":true}`.
105
+ Opening `/` without a token shows the auth wall — that's the security
106
+ working. Log in once with `https://shinobi.yourdomain.com/?token=YOUR_TOKEN`.
107
+
108
+ > ⚠️ **Connecting from Claude Code web/cloud sessions?** Set Cloudflare →
109
+ > SSL/TLS → Edge Certificates → **Minimum TLS Version to 1.2**. With a 1.3
110
+ > minimum, Anthropic's egress gateway (which negotiates TLS 1.2) gets a
111
+ > `TLSV1_ALERT_PROTOCOL_VERSION` reject and every MCP call dies with a 503
112
+ > before reaching your server.
113
+
114
+ ## 5. Migrate an existing local database (optional, one-time)
115
+
116
+ If you've been running Shinobi locally, move your brain up:
117
+
118
+ 1. On your machine: close every client using Shinobi (editor sessions,
119
+ dashboard), then locate `~/.shinobi/shinobi.db`
120
+ (Windows: `C:\Users\<you>\.shinobi\shinobi.db`).
121
+ 2. In the browser SSH window use **Upload file** to drop `shinobi.db` into
122
+ your VM home directory.
123
+ 3. On the VM, place it into the volume and restart:
124
+
125
+ ```bash
126
+ docker stop shinobi
127
+ docker run --rm -v shinobi-data:/data -v "$HOME":/host node:22-slim \
128
+ bash -c 'cp /data/shinobi.db /data/shinobi.db.bak 2>/dev/null; cp /host/shinobi.db /data/shinobi.db && rm -f /data/shinobi.db-wal /data/shinobi.db-shm'
129
+ docker start shinobi
130
+ curl http://127.0.0.1:8765/health
131
+ ```
132
+
133
+ Open the dashboard — your projects, decisions and dead ends are there.
134
+ From now on the server is the single brain; point all clients at it and
135
+ retire the local database.
136
+
137
+ ## 6. Connect clients
138
+
139
+ See [remote-mcp.md → Connecting clients](remote-mcp.md#connecting-clients).
140
+ Short version:
141
+
142
+ ```bash
143
+ claude mcp add --transport http shinobi https://shinobi.yourdomain.com/mcp \
144
+ --header "Authorization: Bearer YOUR_TOKEN"
145
+ ```
146
+
147
+ ## Ongoing costs & care
148
+
149
+ - **GCP**: $0 while this is your only e2-micro in a free region with a
150
+ ≤30 GB standard disk. Check Billing → Reports once after the first week.
151
+ - **Cloudflare**: $0 (tunnel + DNS on Free plan).
152
+ - **Upgrades**: `cd ~/shinobi && git pull && docker build -t shinobi . `
153
+ then `docker stop shinobi && docker rm shinobi` and re-run the
154
+ `docker run` command from step 3 (same token). The database lives on the
155
+ volume and survives.
156
+ - **Backups**: the volume survives container replacement but not project
157
+ deletion. Wire `shinobi sync` to a private git repo (git is included in
158
+ the image):
159
+
160
+ ```bash
161
+ # one-time: fine-grained GitHub PAT with Contents read/write on the sync repo
162
+ docker exec shinobi git clone https://YOUR_PAT@github.com/you/your-sync-repo.git /data/sync
163
+ docker exec shinobi git -C /data/sync config user.name "shinobi-server"
164
+ docker exec shinobi git -C /data/sync config user.email "shinobi@localhost"
165
+ docker exec shinobi node /app/dist/cli.js sync init /data/sync
166
+ docker exec shinobi node /app/dist/cli.js sync push # test it
167
+
168
+ # nightly cron on the VM host:
169
+ ( crontab -l 2>/dev/null; echo '0 3 * * * docker exec shinobi node /app/dist/cli.js sync push' ) | crontab -
170
+ ```
171
+
172
+ The clone lives on the `/data` volume, so credentials and git config
173
+ survive container upgrades.
174
+
175
+ > ⚠️ If the first push dies with `RPC failed; curl 55 ... unexpected
176
+ > disconnect` (common when sending multi-MB binary snapshots from small
177
+ > VMs over HTTP/2), pin the repo to HTTP/1.1 and raise the post buffer —
178
+ > both stick because the config lives on the volume:
179
+ >
180
+ > ```bash
181
+ > docker exec shinobi git -C /data/sync config http.version HTTP/1.1
182
+ > docker exec shinobi git -C /data/sync config http.postBuffer 157286400
183
+ > ```
@@ -0,0 +1,94 @@
1
+ # Getting started with Shinobi (local)
2
+
3
+ From zero to an agent that remembers your project — on one machine, no
4
+ cloud, in about ten minutes. When you outgrow one machine, see
5
+ [remote mode](remote-mcp.md) and the
6
+ [$0/month cloud deployment guide](deploy-gcp-free.md).
7
+
8
+ ## 1. Install
9
+
10
+ ```bash
11
+ npm install -g @shinobiapps/shinobi
12
+ ```
13
+
14
+ Requirements: Node 18+. `better-sqlite3` ships prebuilt binaries for common
15
+ platforms; Windows may need
16
+ [VS Build Tools](https://visualstudio.microsoft.com/visual-cpp-build-tools/)
17
+ as a fallback.
18
+
19
+ ## 2. Bootstrap your project
20
+
21
+ In your project's root:
22
+
23
+ ```bash
24
+ shinobi init
25
+ ```
26
+
27
+ This creates `~/.shinobi/` (SQLite database + config) and writes the MCP
28
+ config for your client — `.mcp.json` for Claude Code, `.cursor/mcp.json`
29
+ for Cursor. For Cline / Continue.dev / Zed, print the snippet instead:
30
+
31
+ ```bash
32
+ shinobi init --print-config
33
+ ```
34
+
35
+ Restart your editor / MCP client. Your agent now has 37 `shinobi` tools.
36
+
37
+ ## 3. Teach the agent to use its memory
38
+
39
+ Memory only pays off if the agent reads it at the start and writes to it as
40
+ it works. Add this to your project's `CLAUDE.md` (or your client's rules
41
+ file):
42
+
43
+ ```markdown
44
+ At the start of each session, call the shinobi `agent_bootstrap` tool for the
45
+ active project to load decisions, dead ends, context and open tasks. Before
46
+ implementing a new approach, call `check_dead_ends`. Log decisions and dead
47
+ ends as you go; call `session_closeout` before finishing.
48
+ ```
49
+
50
+ ## 4. Your first project
51
+
52
+ Tell your agent something like:
53
+
54
+ > Create a shinobi project "Payments refactor" with subtasks for: extract
55
+ > the gateway interface, migrate Stripe calls, add retry logic. Log the
56
+ > decision that we use decimal.js for money math — floats caused rounding
57
+ > bugs.
58
+
59
+ From now on, in any future session, "work on the payments refactor through
60
+ shinobi" gives the agent the full picture: open tasks, decisions with
61
+ rationale, and the approaches that already failed.
62
+
63
+ ## 5. The daily loop
64
+
65
+ | Moment | What happens |
66
+ | --- | --- |
67
+ | Session start | `agent_bootstrap` — decisions, dead ends, context, open tasks |
68
+ | Before a new approach | `check_dead_ends` — "we tried this, it broke because…" |
69
+ | Architectural choice made | `log_decision` with rationale |
70
+ | Approach failed | `log_dead_end` (optionally `never_retry`) |
71
+ | Session end | `session_closeout` — summary, drafts, timeline entry |
72
+
73
+ ## 6. The dashboard
74
+
75
+ ```bash
76
+ shinobi dashboard
77
+ ```
78
+
79
+ → [localhost:8765](http://localhost:8765): Kanban board, decisions, dead
80
+ ends, notes, plans, timeline, analytics. Auth is off on localhost and
81
+ automatic on any other bind.
82
+
83
+ ## 7. Where to go next
84
+
85
+ - **Approvals on your phone** — the agent blocks mid-task until you tap
86
+ approve: see the Push page in the dashboard, and `docs/relay.md` for
87
+ multi-machine realtime.
88
+ - **One brain for every device** (desktop editor + Claude Code web/mobile
89
+ sessions): [remote mode](remote-mcp.md), and the field-tested
90
+ [GCP free tier + Cloudflare Tunnel walkthrough](deploy-gcp-free.md).
91
+ - **Backups / second machine**: `shinobi sync` snapshots the database to a
92
+ private git repo (see README → Cross-machine sync).
93
+ - **Plugins**: drop a `.js` file in `~/.shinobi/plugins/` —
94
+ `docs/plugin-development.md`.